安装

第1步:下载工艺

可以下载工艺作曲家或者手动下载zip或tar.gz档案。最终结果将是相同的,所以通过任何途径,你觉得更舒服。

用Composer下载

您应该运行Composer 1.3.0或更高版本。通过运行,您可以找到安装的Composer版本Composer -V.从你的终端。如果输出低于1.3.0的东西,请运行作曲家自我更新更新Composer安装。

要创建一个新的工艺项目,请运行此命令(替换我/项目/路径使用作曲家应该创建项目的路径):

Composer Create-Project CraftCMS / Craft我/项目/路径

作曲家需要几分钟的时间来加载一切。一旦完成,您将显示成功消息:

用作曲家装载工艺后的成功消息

手动下载存档文件

下载您希望使用的存档格式:

在任何希望您想要的新工艺项目生活的地方提取存档。

如果您在麦克斯,请小心不要丢失那里的隐藏文件(.env..env.example..gitignore., 和Web / .htaccess.)。你可以按命令+转移+在Finder中切换隐藏的文件可见性。

目录结构

一旦工艺的文件到位,您的项目目录应该具有这样的目录结构:

我的project.test.test.├──配置└──......├──模块└──......├──贮存└──......├──模板└──......├──小贩└──......├──网页└──......├──.env.├──.env.example.├──.gitignore.├──composer.json.├──composer.lock.└──工艺

网/文件夹代表您的网站的Web root,它可以重命名为您想要的任何内容(万维网/上市/public_html /, 等等。)。

您可以了解所有这些文件夹和文件是什么以及如何自定义它们目录结构页。

第2步:设置文件权限

如果您使用作曲家下载工艺,您可能会安全地跳过此步骤。

对于妥善运行,PHP需要能够写入以下地方:

  • .env.
  • composer.json.
  • composer.lock.
  • 配置/许可证.Key.
  • 配置/项目/ *
  • 贮存/*
  • 小贩/*
  • Web / 华体会登陆地址Cpresources / *

您应该设置的确切权限取决于系统用户之间的关系,PHP正在运行,谁拥有实际文件夹/文件。

  • 如果它们是相同的用户,请使用744.
  • 如果他们在同一组中,那就使用了774.
  • 如果你不确定,喜欢在边缘上生活,使用777.

嘿IIS粉丝

确保您的网站的Appool帐户也包含这些文件夹/文件的写入权限。

第3步:设置安全密钥

如果您使用作曲家下载工艺,您可能会安全地跳过此步骤。

每个工艺项目都应该具有唯一的安全密钥,这些密钥在安装项目的每个环境之间共享。

您可以生成并分配密钥手动,或者为您提供工艺终端命令

手动设置钥匙

首先生成密码安全密钥,最好使用密码生成器1Password. (打开新窗口)。(没有长度限制。)

然后打开你的.env.文件(您可能需要使用应用程序发送 (打开新窗口)要执行此操作,如果您正在运行MacOS),并找到此行:

security_key =“”

将安全密钥粘贴在引号内并保存文件。

从终端设置密钥

在您的终端中,转到项目的根目录并运行以下命令:

PHP Craft Setup / Security-key

第4步:创建数据库

接下来,您需要为您的工艺项目创建一个数据库。Craft 3支持MySQL 5.5+和PostgreSQL 9.5+。

如果您选择了一个选择,我们会在大多数情况下推荐以下数据库设置:

  • mysql.

    • 默认字符集:UTF8.
    • 默认排序规则:UTF8_UNICODE_CI.
  • PostgreSQL.

    • 字符集:UTF8.

第5步:设置Web服务器

创建一个新的Web服务器以托管您的工艺项目。它的文档根(或“Web Root”)应该指向您的网/目录(或者您将其重命名为的任何目录)。

如果你没有使用MAMP. (打开新窗口)或者另一个本地适用工具,您可能需要更新您的主持人文件,因此您的计算机知道将所选主机名的请求路由到本地计算机。

  • MacOS / Linux / UNIX/ etc / hosts
  • 视窗\ Windows \ System32 \ drivers \ etc \ hosts

您可以通过指向您的Web浏览器来测试是否正确设置了所有内容http:// /index.php?p=admin/install(替代使用您的Web服务器的主机名)。如果显示了Craft的设置向导,则主机名正确地解决您的工艺安装。

我们建议使用。测试TLD为当地发展,而不是。当地的在宏后与Bonjour的冲突会导致性能问题 (打开新窗口)

步骤6:运行安装向导

最后,是时候运行Craft的设置向导了。你可以从你的身上运行终端或者你网页浏览器

终端设置

在您的终端中,转到项目的根目录并运行以下命令以启动设置向导:

PHP Craft设置

该命令将询问您几个问题要学习如何连接到您的数据库,然后启动Craft安装程序。一旦完成,您应该能够从Web浏览器访问您的新工艺网站。

Web浏览器设置

在您的Web浏览器中,转到http:// /index.php?p=admin/install(替代使用您的Web服务器的主机名)。如果您到目前为止已经正确地完成了一切,您应该被Craft的设置向导打招呼。

工艺安装屏幕

安装程序的第一步是接受许可协议 (打开新窗口)。通过协议滚动(当然读取所有协议),然后单击“get it”按钮接受。

工艺安装许可协议

第二步是输入数据库连接信息。

如果设置向导跳过此步骤,它是因为Craft已能够连接到您的数据库。

工艺安装数据库连接信息

安装程序的第三步是创建管理员帐户。不要成为其中之一那些人并一定要选择强密码。

工艺安装创建用户帐户

最后一步是定义系统名称,基本URL和语言。

工艺安装系统设置

单击“完成”以完成安装过程。几秒钟后,你应该有一个工作工艺安装!

如果成功,Craft将将浏览器重定向到控制面板。

工艺安装完成

恭喜,你刚刚安装了工艺!

现在建立一些令人难以置信的东西。