ubuntu上thinkphp依赖如何管理

Ubuntu 上 ThinkPHP 依赖管理指南

一 环境准备

• 安装 PHP 与常用扩展（适配 ThinkPHP 6 推荐 PHP 7.4+）：sudo apt update && sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-zip php-gd php-bcmath
• 安装 Composer：curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer
• 安装 Web 服务器（二选一）：Nginx 或 Apache；建议 Nginx + PHP-FPM。示例：sudo apt install nginx 或 sudo apt install apache2

二 使用 Composer 进行依赖管理

• 创建项目：composer create-project topthink tp（如需指定版本可用 topthink=6.0.*）
• 添加依赖：composer require 包名（如：monolog/monolog）；删除依赖：composer remove 包名
• 安装/更新：composer install（安装 composer.lock 锁定的版本）、composer update（更新并写入新锁文件）
• 生产环境优化：composer install --optimize-autoloader --no-dev
• 说明：ThinkPHP 6 项目天然使用 Composer 管理依赖，上述命令即可覆盖日常增删改查

三 框架自动加载与项目配置

• 框架入口自动加载：ThinkPHP 6 的 public/index.php 默认已包含 Composer 自动加载：require DIR.‘/…/vendor/autoload.php’; 无需额外配置即可使用通过 Composer 安装的类库
• 全局命令（可选）：全局安装 ThinkPHP 后可使用 think 命令创建项目：composer global require topthink；确保将 Composer 全局 bin 目录加入 PATH，然后使用 think new 项目名 创建新项目

四 部署与运行要点

• 目录与权限：将 Web 根目录指向 public；确保 runtime 目录可写：chmod -R 755 runtime
• Nginx 配置要点：root 指向项目 public；PHP 处理使用 fastcgi_pass unix:/run/php/php7.4-fpm.sock（按实际 PHP 版本调整）；URL 重写示例：try_files $uri $uri/ /index.php?$query_string;
• 常用运行方式：开发环境可用 php think run 启动内置服务器（默认 http://127.0.0.1:8000）；生产环境建议使用 Nginx/Apache + PHP-FPM

五 常见问题排查

• 502 Bad Gateway：检查 PHP-FPM 是否运行，确认 Nginx 配置中的 fastcgi_pass 路径与版本匹配
• 路由 404/失效：确认 Web 服务器已启用重写规则（Nginx 使用 try_files；Apache 启用 mod_rewrite 并配置 .htaccess）
• 类库找不到：执行 composer install，确认 vendor/autoload.php 存在且被入口文件正确引入，必要时执行 composer dump-autoload