Debian系统ThinkPHP项目如何管理

Debian系统下管理ThinkPHP项目的最佳实践

一 环境准备与安装

• 更新系统并安装基础组件（以 Debian 11/12 为例，PHP 版本请与项目要求匹配，示例为 PHP 7.4）：
  • sudo apt update && sudo apt install -y nginx mysql-server composer
  • sudo apt install -y php php-fpm php-mysql php-mbstring php-xml php-curl php-zip php-gd php-bcmath
• 安装与初始化 Composer（命令行工具）：
  • sudo apt install -y curl php-cli php-mbstring git unzip
  • curl -sS https://getcomposer.org/installer | php
  • sudo mv composer.phar /usr/local/bin/composer
• 建议将站点目录设为 /var/www/your_project，Web 访问根目录指向 public，并确保数据库（如 MySQL/MariaDB）已安装并运行。

二 项目部署与目录规范

• 获取代码与安装依赖：
  • 方式一（全新项目）：composer create-project topthink your_project
  • 方式二（已有项目）：git clone /var/www/your_project && cd /var/www/your_project && composer install
• 目录与权限（Web 根目录为 public，运行目录 runtime 需可写）：
  • sudo chown -R www-data:www-data /var/www/your_project
  • sudo chmod -R 755 /var/www/your_project
  • sudo chmod -R 775 /var/www/your_project/runtime
• 配置数据库连接（优先使用 .env，或 config/database.php）：
  • DB_TYPE=mysql；DB_HOST=127.0.0.1；DB_NAME=your_db；DB_USER=your_user；DB_PWD=your_pass；DB_PORT=3306
• 生产与开发开关：
  • 生产环境关闭调试：config/app.php 中设置 ‘app_debug’ => false
  • 开发环境可用内置服务器：php think run（仅用于开发）。

三 Web服务器配置

• Nginx 推荐配置（站点配置示例，root 指向 public，开启 PATH_INFO 兼容）：
  • server {
    • listen 80; server_name your_domain.com;
    • root /var/www/your_project/public; index index.php;
    • 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; }
  • }
  • 启用站点：sudo ln -s /etc/nginx/sites-available/your_project /etc/nginx/sites-enabled/ && sudo nginx -t && sudo systemctl reload nginx
• Apache 要点（启用 mod_rewrite，AllowOverride All，DocumentRoot 指向项目根目录，.htaccess 由框架提供）
• 常见问题速查：
  • 502 Bad Gateway：检查 PHP-FPM 是否运行（systemctl status php7.4-fpm），核对 fastcgi_pass 路径
  • 路由 404/失效：确认 Nginx 包含 try_files $uri $uri/ /index.php?$query_string; 规则。

四 日常运维与更新

• 依赖与自动加载：
  • 新增/升级库：在项目根目录执行 composer require/install/update，自动生成/更新 vendor/autoload.php
  • 第三方库也可用 PECL/apt 安装扩展（如 Redis）：sudo apt-get install php-redis，然后重启 PHP-FPM
• 发布流程（零停机思路）：
  • 代码拉取：git pull 或 rsync/scp 更新
  • 安装/更新依赖：composer install --optimize-autoloader --no-dev
  • 清缓存：php think clear
  • 平滑切换：使用 symlink 原子切换目录或蓝绿发布
• 日志与排错：
  • Web 错误日志：Nginx /var/log/nginx/error.log；PHP-FPM 日志（/var/log/php7.4-fpm.log 或 pool 配置指定）
  • 应用日志：runtime 目录下的日志文件，排查路由、数据库、权限等问题
• 性能与安全：
  • 开启 OPcache（生产环境强烈建议）
  • 使用 HTTPS（Let’s Encrypt：sudo certbot --nginx -d your_domain.com）
  • 禁止访问敏感文件：location ~ /.env { deny all; }。

五 一键检查清单