Skip to content
This repository has been archived by the owner on Dec 1, 2023. It is now read-only.

Latest commit

 

History

History
85 lines (46 loc) · 3.02 KB

安装.md

File metadata and controls

85 lines (46 loc) · 3.02 KB

安装

chemex 是个标准的 Laravel应用程序,也适用于所有的 LNMP/WNMP/DNMP 环境,虽然部署方式有很多,但仍然强烈建议使用 Docker 方式部署。

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 版本一致。

安装步骤

生产环境下为遵守安全策略,非常建议在服务器本地进行部署,暂时不提供相关线上初始化安装的功能。因此,虽然前期部署的步骤较多,但已经为大家自动化处理了很大部分的流程,只需要跟着下面的命令一步步执行,一般是不会有部署问题的。

  1. 为你的计算机安装 PHP8.1 环境,参考:PHP官方

  2. 为你的计算机安装 MySQL 或者 mariadb

  3. 在你想要的地方,执行 mkdir chemex && cd chemex

  4. 执行 git clone https://gitee.com/celaraze/chemex.git .,注意末尾的 . 也是需要包含的。

  5. 执行 git submodule init && git submodule update

  6. 执行 cp .env.example .env

  7. 根据 .env 文件中注释的指引进行配置。

  8. 执行 composer install -vvv 安装依赖。

  9. 你可能使用的web服务器为 nginx 以及 apache,无论怎样,应用的起始路径在 /public 目录,请确保指向正确,同时程序的根目录权限应该调整为:拥有者和你的 Web 服务器运行用户一致,例如 www 用户,且根目录权限为 755

    /storage 目录设置为 755 权限。

    /public 目录设置为 755 权限。

  10. 修改web服务器的伪静态规则为:try_files $uri $uri/ /index.php?$args;

  11. 执行 php artisan chemex:install

  12. 此时可以通过访问 http://your_domain 来使用咖啡壶。管理员账号密码为:admin / admin