在 Ubuntu 上搭建 ThinkPHP 开发环境，很多人以为“安装依赖”会涉及一堆手动配置，实际核心只有一个：把 Composer 用对。只要先确认 Composer 可用，再按项目创建、启动验证、追加扩展包这条顺序操作，ThinkPHP 的基础依赖通常可以一次装齐。本文把每一步拆开说明，并补充新手最容易卡住的权限与目录判断方法，方便你直接落地。

先确认 Composer 是否可用

ThinkPHP 的依赖管理依赖 Composer 完成，所以在创建项目之前，先确保 Ubuntu 系统里已经安装好 Composer。

如果本机还没有安装，可以前往 Composer 官网获取安装方式并完成部署。文章原始流程强调的重点很明确：只要 Composer 安装正常，后续 ThinkPHP 依赖安装基本就是标准化操作。

这里还需要注意一个常见问题：如果项目目录权限较严，执行 Composer 命令时有时可能需要 sudo。是否需要提权，取决于你的 Ubuntu 用户权限和 Web 目录的归属。

进入目录并创建 ThinkPHP 项目

确认 Composer 可用后，先切换到你的项目存放目录。示例中常见的 Web 路径是 /var/www/html：

cd /var/www/html

进入目录后，直接使用 Composer 创建一个新的 ThinkPHP 项目：

composer create-project topthink/think your_project_name

其中，your_project_name 需要替换成你自己的项目名称。

这条命令的作用不只是下载框架本体，还会从远程仓库拉取 ThinkPHP 所需的依赖包，并在创建项目时一并完成安装。对于初次接触 ThinkPHP 的用户来说，这一步能省掉大量手动下载和配置工作。

安装完成后如何启动并验证

项目创建完成后，进入新生成的项目目录，并启动 PHP 内置开发服务器：

cd your_project_name
php run start

默认情况下，服务会监听本地 8000 端口。浏览器打开下面的地址：

http://localhost:8000

如果页面能够正常显示 ThinkPHP 欢迎页，说明框架主体和基础依赖已经安装完成，当前环境可以继续用于本地开发。

如果这一步访问失败，通常优先检查三件事：当前是否已经进入正确的项目目录、命令是否执行成功、端口 8000 是否已被其他服务占用。

后续添加第三方依赖怎么做

基础项目跑起来后，如果还需要额外功能，可以继续通过 Composer 安装第三方库。示例里提到的日志库是 monolog/monolog，安装命令如下：

composer require monolog/monolog

执行后，Composer 会自动完成下载、安装，并同步更新 composer.json 中的依赖信息。也就是说，后续扩展能力时，仍然不需要手动去整理包文件或修改依赖清单。

对 ThinkPHP 项目来说，这也是最常见的扩展方式：缺什么包，就通过 require 按需补上。

新手最容易遇到的两个问题

1. 权限不足

如果项目目录位于 /var/www/html 这类系统 Web 路径下，当前用户可能没有写入权限。这时 Composer 执行失败，往往不是命令本身有问题，而是目录权限限制导致。

原始内容已经提醒过这一点：有些场景下可能需要使用 sudo。不过是否使用提权命令，建议先根据当前目录归属和开发环境习惯判断，避免把所有文件都写成 root 权限。

2. 误把依赖安装理解成手动配置

ThinkPHP 在 Ubuntu 下的依赖安装，本质上并不是逐个处理扩展包，而是依靠 Composer 自动完成。无论是创建项目时安装框架依赖，还是后续增加第三方库，核心入口都还是 Composer。

如果你已经完成了 Composer 安装，那么整套流程基本可以理解为：

进入目录 → 创建项目 → 启动服务 → 按需追加依赖

Ubuntu 下 ThinkPHP 依赖安装流程总结

把流程收束起来看，Ubuntu 系统中安装 ThinkPHP 依赖并不复杂：

cd /var/www/html
composer create-project topthink/think your_project_name
cd your_project_name
php run start
composer require monolog/monolog

只要 Composer 可用、目录权限正常，这几步通常就足以完成一个 ThinkPHP 项目的初始化与扩展。对于想快速搭好本地 PHP 开发环境的用户，这也是最省事、最接近实际生产习惯的一套入门路径。