ubuntu上thinkphp项目如何部署与调试

Ubuntu 上 ThinkPHP 项目部署与调试

一环境准备与版本兼容

更新系统并安装基础组件（以 Ubuntu 20.04/22.04 为例，PHP 版本请与项目匹配）：
- 安装：Nginx/Apache、PHP-FPM、MySQL、Composer
- 命令：sudo apt update && sudo apt install -y nginx php-fpm php-mysql mysql-server composer
PHP 扩展建议启用：PDO、OpenSSL、MBstring、CURL、XML、GD、ZIP、BCMath（按需增减）
ThinkPHP 版本与 PHP 兼容建议：
- ThinkPHP 5.0+：需 PHP >= 5.6.0
- ThinkPHP 6.0：需 PHP >= 7.2.5
验证：php -v、nginx -t、systemctl status php*-fpm、systemctl status mysql

二部署步骤

上传或拉取代码（示例目录：/var/www/html/your_project）
- Git：git clone /var/www/html/your_project
- 或 SCP/Rsync 上传后进入项目目录
安装依赖：composer install --optimize-autoloader --no-dev
配置环境
- 数据库等写入 .env 或相应配置文件（如 database.php），确保 runtime 目录可写
- 权限：sudo chown -R www-data:www-data /var/www/html/your_project && sudo chmod -R 755 /var/www/html/your_project
Web 服务器根目录必须指向 public

Nginx 示例（/etc/nginx/sites-available/your_project）

要点：root 指向 public；try_files 支持 PATH_INFO；fastcgi_pass 指向正确的 PHP-FPM socket

示例：

server {
  listen 80;
  server_name your_domain.com;
  root /var/www/html/your_project/public;
  index index.php index.html;

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

  location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;  # 按实际版本调整
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
  }

  # 安全：禁止访问敏感文件
  location ~ /\.env { deny all; }
  location ~ /\.ht   { deny all; }
}

启用站点：sudo ln -s /etc/nginx/sites-available/your_project /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl reload nginx

Apache 方案（可选）

启用模块：sudo a2enmod rewrite

虚拟主机示例（/etc/apache2/sites-available/your_project.conf）

<VirtualHost *:80>
  ServerName your_domain.com
  DocumentRoot /var/www/html/your_project/public
  <Directory /var/www/html/your_project/public>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
  </Directory>
</VirtualHost>

启用站点：sudo a2ensite your_project.conf && sudo systemctl reload apache2

生产建议
- 关闭调试：将 config/app.php 中的 ‘app_debug’ => false
- 启用 HTTPS（Let’s Encrypt）：sudo certbot --nginx -d your_domain.com（或 --apache）

三调试与常见问题排查

开发期快速验证
- 进入项目目录执行：php think run -H 0.0.0.0 -p 8000（仅开发环境使用）
查看日志定位问题
- Nginx：/var/log/nginx/error.log
- PHP-FPM：/var/log/php7.4-fpm.log（按实际版本）
常见错误与修复
- 502 Bad Gateway：检查 PHP-FPM 是否运行（systemctl status php*-fpm），核对 Nginx 中 fastcgi_pass 的 socket 路径 与 PHP-FPM 监听一致
- 路由 404/白屏：确认 Nginx 的 try_files $uri $uri/ /index.php?$query_string; 已配置；确保 Web 根目录为 public
- Permission denied：确认 runtime、日志、上传目录对 www-data 可写
- Composer 安装慢：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 数据库连接失败：核对 .env/database.php 中 host、port、dbname、user、password 是否正确，数据库是否允许远程/本地连接

四生产优化与安全加固

性能优化
- 启用 OPcache（生产环境强烈建议）
- 使用 Redis 做会话/缓存（需安装并配置相应扩展与驱动）
安全建议
- 关闭调试模式（‘app_debug’ => false）
- 禁止访问 .env 等敏感文件（Nginx location ~ /.env { deny all; }）
- 仅开放必要端口（如 80/443），使用 UFW 或云安全组限制来源
- 定期更新系统、PHP、Nginx、MySQL 与依赖包，关注框架安全公告

最新问答

相关标签