记录正在发生的一切

解禁 PHP 函数#

Flarum 和 Composer 依赖 proc_open 和 putenv 函数，这些函数可能在默认 PHP 配置中被禁用。

1. 检查禁用函数：

   1
   php -i | grep disable_functions
   

   如果输出包含 proc_open 或 putenv，需要解禁。

2. 编辑 PHP 配置文件： 编辑 PHP CLI 配置文件（通常为 /www/server/php/82/etc/php.ini）：

   1
   nano /www/server/php/82/etc/php.ini
   

   找到 disable_functions 行，移除 proc_open 和 putenv（如果存在）。例如：

   1
   disable_functions = exec,system
   

   保存后重启 PHP-FPM：

   1
   sudo systemctl restart php-fpm
   

3. 验证函数解禁：

   1
   php -r "var_dump(function_exists('proc_open'), function_exists('putenv'));"
   

   输出应为：

   1
   bool(true)
   2
   bool(true)
   

安装 PHP 扩展#

Flarum 要求 fileinfo 等扩展，必须提前安装。

1. 检查已安装扩展：

   1
   php -m | grep -E "fileinfo|gd|mbstring|pdo_mysql|openssl|json|tokenizer|curl|zip"
   

   确保列出 fileinfo 等扩展。如果缺少，安装以下扩展：

2. 安装扩展：

   • Ubuntu/Debian：

     1
     sudo apt-get update
     2
     sudo apt-get install php8.2-fileinfo php8.2-mbstring php8.2-gd php8.2-curl php8.2-zip php8.2-pdo-mysql php8.2-openssl php8.2-tokenizer
     

   • CentOS/RHEL：

     1
     sudo yum install php82-php-fileinfo php82-php-mbstring php82-php-gd php82-php-curl php82-php-zip php82-php-pdo-mysql php82-php-openssl php82-php-tokenizer
     

3. 验证扩展：

   1
   php -m | grep fileinfo
   

   确保输出包含 fileinfo。

安装 Composer（如未安装）#

在服务器终端执行以下命令安装 Composer：

1
cd /www/wwwroot/your-domain
2
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
3
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
4
php -r "unlink('composer-setup.php');"

验证 Composer 是否安装成功：

1
composer -V

注意：建议以非 root 用户运行 Composer，以避免权限问题：

1
sudo chown -R <your-username>:<your-group> /www/wwwroot/your-domain
2
su <your-username>

安装 Flarum 核心#

在站点目录下安装 Flarum：

1
cd /www/wwwroot/your-domain
2
composer create-project flarum/flarum .

注意事项：

• 如果仍提示 proc_open is disabled 或 putenv() 错误，重新检查第二步的函数解禁。
• 如果提示缺少扩展，确认第二步的扩展安装是否成功。

Nginx 配置#

1. 修改 Nginx 配置文件：

   • 编辑站点对应的 Nginx 配置文件（通常在 /www/server/nginx/conf 或通过宝塔面板的站点设置）。
   • 确保 root 指向 Flarum 的 public 目录：

     1
     root /www/wwwroot/your-domain/public;
     

   • 在 server 块中添加自定义配置文件引用（如果需要）：

     1
     include /www/wwwroot/your-domain/.nginx.conf;
     

     注意：确保 /www/wwwroot/your-domain/.nginx.conf 文件存在。如果不存在，可创建一个空文件或移除此行。

2. 伪静态规则： 在宝塔面板的站点设置中，添加以下伪静态规则：

1
location / {
2
    try_files $uri $uri/ /index.php?$query_string;
3
}

3. 上传限制： 在 Nginx 配置文件中添加：

   1
   client_max_body_size 50M;
   

4. 保存后重启 Nginx：

   1
   sudo systemctl restart nginx
   

PHP 配置调整#

• 必要扩展：已在上一步安装，确认以下扩展已启用：
  • fileinfo
  • pdo_mysql
  • mbstring
  • openssl
  • json
  • tokenizer
  • curl
  • gd
  • zip
• 上传限制：在宝塔的 PHP 设置中，修改：
  • upload_max_filesize = 50M
  • post_max_size = 50M
• 权限设置：确保 public/assets 和 storage 目录对 Web 服务器用户（通常为 www 或 nginx）可写：

  1
  chown -R www:www /www/wwwroot/your-domain/storage
  2
  chmod -R 775 /www/wwwroot/your-domain/storage
  3
  chown -R www:www /www/wwwroot/your-domain/public/assets
  4
  chmod -R 775 /www/wwwroot/your-domain/public/assets
  

1. Composer 报错 proc_open is disabled#

原因：PHP 禁用了 proc_open，导致 Composer 无法调用 unzip 或 7z。

解决：

• 编辑 /www/server/php/82/etc/php.ini，找到 disable_functions，移除 proc_open。
• 安装 unzip：

  1
  # Ubuntu/Debian
  2
  sudo apt-get install unzip
  3
  # CentOS/RHEL
  4
  sudo yum install unzip
  

• 重启 PHP-FPM：

  1
  sudo systemctl restart php-fpm
  

2. Composer 报错 putenv()#

原因：PHP 禁用了 putenv 函数。

解决：

• 编辑 /www/server/php/82/etc/php.ini，移除 disable_functions 中的 putenv。
• 重启 PHP-FPM：

  1
  sudo systemctl restart php-fpm
  

3. 缺少 fileinfo 扩展#

原因：Flarum 依赖 fileinfo 扩展，但未安装或启用。

解决：

• 参考“第二步：预配置 PHP 环境”中的扩展安装步骤。

4. 文件权限问题（如 public/assets 或 storage 不可写）#

原因：Web 服务器用户对 public/assets 或 storage 目录没有写权限。

解决：

• 确保目录权限正确：

  1
  chmod -R 775 /www/wwwroot/your-domain/storage
  2
  chown -R www:www /www/wwwroot/your-domain/storage
  3
  chmod -R 775 /www/wwwroot/your-domain/public/assets
  4
  chown -R www:www /www/wwwroot/your-domain/public/assets
  

• 替换 www 为实际的 Web 服务器用户（可通过 ps aux | grep nginx 或 ps aux | grep php-fpm 确认）。

5. 后台清除缓存提示 Could not write to filesystem#

原因：Web 服务器用户对 storage/cache 目录没有写权限。

解决：

• 修复 storage/cache 目录权限：

  1
  chown -R www:www /www/wwwroot/your-domain/storage/cache
  2
  chmod -R 775 /www/wwwroot/your-domain/storage/cache
  

• 从命令行清除缓存：

  1
  cd /www/wwwroot/your-domain
  2
  php flarum cache:clear
  

• 替换 www 为实际的 Web 服务器用户。
• 确认后重新尝试后台清除缓存。

6. Composer 下载缓慢#

解决：配置国内镜像源：

1
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/