chemex 是个标准的 Laravel应用程序,也适用于所有的 LNMP/WNMP/DNMP 环境,虽然部署方式有很多,但仍然强烈建议使用 Docker 方式部署。
Docker 部署方式不会建立数据库容器,也意味着你必须有一个已有的数据库,在启动 chemex 后需要对 .env
文件做配置。
docker pull celaraze/chemex:latest
注意 your_path 为你的宿主机某个目录,chemex 根目录有一个 .env.example 的环境变量配置文件,复制这个文件到 your_path 下并改名为 .env,然后修改 .env 中的数据库连接信息。
docker run -itd --name chemex --restart=always -p 8000:8000 -v /your_path/.env:/var/www/html/laravel/.env celaraze/chemex:latest
即可通过 http://127.0.0.1:8000
访问 chemex。
初始化数据库:如果您是第一次使用 chemex,则需要执行数据库迁移。
docker exec -it chemex /bin/bash
进入 docker 容器执行命令:cd /var/www/html/laravel && php artisan chemex:install
。
git:用于管理版本,部署和升级必要工具。
PHP:仅支持 PHP8.1。
composer:PHP 的包管理工具,用于安装必要的依赖包。
MySQL 5.7:数据库引擎,理论上 MariaDB 10.2 + 兼容支持。
ext-zip:扩展。
ext-json:扩展。
ext-fileinfo:扩展。
ext-ldap:扩展。
ext-bcmath:扩展。
ext-mysqli:扩展。
ext-xml:扩展。
ext-xmlrpc:扩展。
以上扩展安装过程注意版本必须与 PHP 版本一致。
生产环境下为遵守安全策略,非常建议在服务器本地进行部署,暂时不提供相关线上初始化安装的功能。因此,虽然前期部署的步骤较多,但已经为大家自动化处理了很大部分的流程,只需要跟着下面的命令一步步执行,一般是不会有部署问题的。
-
为你的计算机安装
PHP8.1
环境,参考:PHP官方 。 -
为你的计算机安装
MySQL
或者mariadb
。 -
在你想要的地方,执行
mkdir chemex && cd chemex
。 -
执行
git clone https://gitee.com/celaraze/chemex.git .
,注意末尾的.
也是需要包含的。 -
执行
git submodule init && git submodule update
。 -
执行
cp .env.example .env
。 -
根据
.env
文件中注释的指引进行配置。 -
执行
composer install -vvv
安装依赖。 -
你可能使用的web服务器为
nginx
以及apache
,无论怎样,应用的起始路径在/public
目录,请确保指向正确,同时程序的根目录权限应该调整为:拥有者和你的 Web 服务器运行用户一致,例如 www 用户,且根目录权限为755
。/storage
目录设置为755
权限。/public
目录设置为755
权限。 -
修改web服务器的伪静态规则为:
try_files $uri $uri/ /index.php?$args;
。 -
执行
php artisan chemex:install
。 -
此时可以通过访问
http://your_domain
来使用咖啡壶。管理员账号密码为:admin / admin
。