介绍和安装

Masonite 是一个致力于为开发者提供功能齐全的现代 Python Web 框架，框架包含诸多开发者工具，开箱即用的功能以及极具扩展性的程序架构。 Masonite 非常适合 Web 初学者来开发他们的第一个 Web 应用，当然， Masonite 也适合有经验的 Web 开发人员，他们只需要充分利用 Masonite 的功能即可。

从安装到部署，Masonite 一直都注重于高效，简单地进行 Web 开发，因此开发人员可以尽可能快地将 idea 落地。将其用于下一个 SaaS！使用一次，你就将喜欢上 Masonites 这个web框架。

如果你是一位视觉学习者，你可以在MasoniteCasts.com上看一些和Masonite相关的教学视频。

Masonite的一些重要功能

• 使用邮件提供程序以及 SMTP 和 Mailgun 驱动程序轻松发送电子邮件；
• 利用广播系统以及 Pusher 和 Ably 驱动程序从服务器发送 Websocket 请求；
• IOC 容器和自动解决依赖项注入；
• 开发人员可以轻松地向框架添加功能；
• 简单地配置静态文件配置；
• Active Record 类型的 ORM 称为 Orator；
• 一个非常有用的命令行工具，称为 Craft ；
• 扩展性很强

这些功能以及许多其他功能均已包含在框架里，开箱即用。

环境要求

要使用 Masonite，你需要：

• Python 3.5 及以上的版本
• 最新版本的 OpenSSL
• Pip3

本文档使用的所有 Python 和 pip 命令都适用于正确的 Python 3 版本。例如，在运行 python 命令的任何地方，都假设是 Python3.5 及以上版本。如果您对任何安装步骤有疑问，请先确保命令使用于 Python3.5 及以上版本，而不是 2.7 或更低版本。

Linux

如果您使用的是 Linux 系统，则需要 Python dev 软件包和 libssl 软件包。您可以通过以下命令下载这些软件包：

基于 Debian 和 Ubuntu 的 Linux 发行版

$ sudo apt install python3-dev python3-pip libssl-dev build-essential python3-venv

您也可以使用以下命令指定您的python3.x-dev版本：

$ sudo apt-get install python3.6-dev python3-pip libssl-dev build-essential python3-venv

基于企业 Linux 的发行版(Fedora，CentOS，RHEL，… )

# dnf install python-devel openssl-devel

安装

安装遇到问题可在本文章底部发起提问帖。

Masonite 易于安装和使用。如果您要使用 Masonite 的早期版本，则某些安装步骤的顺序已更改。

首先，打开终端并转到您要在其中创建应用程序的目录。您可能想要在编程目录中创建它，例如：

$ cd ~/programming
$ mkdir myapp
$ cd myapp

如果您在 Windows 上，则可以只创建一个目录并在 Powershell/cmd 中打开该目录。

激活我们的虚拟环境（可选）

这个在技术上是可选的，强烈建议你选择执行此步骤。如果不想在系统 Python 上安装 masonite 的所有依赖项，可以创建一个虚拟环境来使用。如果要使用虚拟环境，则通过运行:

$ python -m venv venv
$ source venv/bin/activate

Windows 系统:

$ python -m venv venv
$ ./venv/Scripts/activate

这里的 python 命令使用的是 python3。对于 UNIX 机器，默认情况下，我们可能运行 Python2（通常为2.7）。也可以在机器上为 python3 设置别名，或者只要看到 Python 命令就运行python3。

例如，运行 python3 -m venv venv 而不是 python -m venv venv

安装 Masonite

现在我们可以安装 Masonite 了。我们可以使用 craft 命令来完成安装:

$ pip install masonite

安装了Masonite，现在就可以访问 craft 命令行工具了。在使用过程中，craft 将成为最好的工具。会很快的熟悉它。

可以通过运行:

$ craft

会看到一些命令的列表，如 install 和 new

创建项目

好了，现在准备创建第一个项目。我们现在应该可以使用 craft 命令了，可以通过运行以下命令检查一下:

$ craft

我们现在只需要关注 craft new 命令。创建新项目只需运行:

$ craft new

这会运行 craft install 来安装我们的依赖项。

这将下载安装包且解压，接下来我们只需进入项目目录对 requirements.txt 里的依赖项进行安装。

其他命令

现在 Masonent 已完全安装，我们可以列出所有可用的命令：

$ craft

应该会打印很多命令。

运行服务器

接下来，我们可以使用另一个craft命令来运行服务器：

$ craft serve

恭喜你！您已经设置了第一个 Masonite 项目！继续学习更多有关如何使用 Masonite 构建应用程序的信息。

您可以通过阅读 Craft 命令 文档，或者学习如何创建 Web 应用程序首先阅读 路由。

Masonite 使用 romantic versioning 控制而不是 semantic versioning 语义版本标示。 因此，所有次要版本 (2.0.x ) 将包含错误修复和完全向后兼容的功能版本。确保始终使用最新的次要版本更新您的应用程序，以充分利用 Masonite 的版本策略。

本译文仅用于学习和交流目的，转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议，如果我们的工作有侵犯到您的权益，请及时联系我们。

原文地址：https://learnku.com/docs/masonite/2.3/re...

译文地址：https://learnku.com/docs/masonite/2.3/re...