README

一个支持ExpressionEngine的PHP dotenv的模板，用于在git部署（如Laravel Forge）下改进配置管理。还增加了Laravel Mix来处理资源编译，并附带插件来处理资源版本化URL。《a href="https://tailwind.org.cn/docs/what-is-tailwind/" rel="nofollow noindex noopener external ugc">Tailwind CSS也被添加，因为它非常棒，为什么不试试呢。

需求

1. Composer
2. PHP 7或更高版本
3. MySQL 5.6或更高版本
4. Node.JS / NPM

安装

1. 将此存储库作为zip文件下载并解压，或者运行composer create-project webteractive/expressionengine-env your-app。
2. 运行composer install来安装依赖项。如果您使用composer create-project方式，则此步骤是可选的。
3. 将migration.sql文件导入到空数据库中，例如（mysql/mariadb：mysql -uuser -p theemptydb < path/to/migration.sql）。
4. 将.env.stub重命名为env并更新所需的密钥。如果您使用composer create-project方式，则此步骤是可选的。
5. 访问管理页面，通过访问/admin.php来验证安装。初始账户是admin / secret2019。请确保更新密码！

里面有什么？

快速浏览您将在expressionengine-env项目中看到的顶级文件和目录。

.
├── assets
├── node_modules
├── public
├── system
├── vendor
├── .env.stub
├── .gitignore
├── AUTHORS.md
├── composer.json
├── composer.lock
├── LICENSE.txt
├── Makefile
├── migration.sql
├── package-lock.json
├── package.json
├── README.md
├── tailwind.js
└── webpack.mix.js

迁移SQL

migration.sql是一个刚安装好的ExpressionEngine的SQL转储文件，其中预安装了mix插件。一旦导入此文件，您就不需要运行ExpressionEngine安装过程。您需要做的就是登录到管理（访问/admin.php），添加更多配置，并最终更新最初提供的超级安全的密码。

环境变量

所有分配给env辅助方法的配置密钥都不会通过管理进行更改。这是不要通过修改配置弄乱您的git的关键。

BASE_PATH - 存放ExpressionEngine文件的路径。这应该是可以找到system的目录。此键是必需的。

BASE_URL - ExpressionEngine实例的基本URL。此键是必需的。

DB_NAME - 数据库名。此键是必需的。

DB_USER - 数据库用户名。此键是必需的。

DB_PASSWORD - 数据库用户密码。此键是必需的。

ENV - ExpressionEngine安装的当前环境。对于本地开发，值应该是local以启用LiveReload。默认为production。

ERROR_VISIBILITY - 确定在发生时谁可以看到PHP/MySQL错误。默认为1。见更多详细信息。

资源捆绑

还提供了一个webpack.mix.js文件，以便您立即开始对资产进行打包。如果您熟悉Laravel Mix的用法，那么这对您来说毫无压力！如果您第一次接触Laravel Mix，请访问https://laravel-mix.com/了解更多关于其工作方式的信息。

assets目录应包含所有源资产。但如果您喜欢冒险，那么请随意放置！只需记住，将您的打包文件放在public目录内。在webpack.mix.js文件中查看示例条目以获取更多详细信息。

要开始打包，请运行npm run dev以在开发模式下快速编译资产。要监视更改，请运行npm run watch。每当运行npm run watch时，LiveReload也会启用，因此当检测到资产更改（编译后）时，浏览器应该会重新加载。要为生产环境编译，请运行npm run prod。

还提供了一个Makefile，其中包含一些快捷命令，如果您的操作系统（Linux和macOS）支持它。运行make dev以开始开发，这将触发npm run watch。运行make prod以编译生产环境。