如何在centos中完成thinkphp开发环境搭建

作者：袖梨 2026-07-29

一、做好前置准备

先确认CentOS系统已经更新到最新版本，再安装gcc、make等基础开发工具：

sudo yum update -ysudo yum groupinstall "Development Tools" -y

二、安装PHP和必要扩展

ThinkPHP 8.x要求PHP版本≥8.0，需安装PHP核心、CLI、FPM及常用扩展（如mysqlnd、gd、mbstring等）。推荐通过Remi仓库安装（支持最新PHP版本）：

添加EPEL和Remi仓库：

sudo yum install epel-release -ysudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm -y# CentOS 7# CentOS 8需替换为对应Remi仓库地址

启用PHP 8.0仓库（以8.0为例，可根据需求替换为8.1/8.2）：
```
sudo yum-config-manager --enable remi-php80
```

安装PHP及扩展：

sudo yum install php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml php-curl php-bcmath -y

启动PHP-FPM并设置开机自启：

sudo systemctl start php-fpmsudo systemctl enable php-fpm

检查PHP版本：
```
php -v
```
输出信息中应包含PHP 8.x版本。

三、以Nginx为例部署Web服务器

处理HTTP请求需要为ThinkPHP配备Web服务器，建议选用高性能、轻量级的Nginx：

安装Nginx：
```
sudo yum install nginx -y
```

启动Nginx并设置开机自启：

sudo systemctl start nginxsudo systemctl enable nginx

在浏览器中打开服务器IP；页面若显示Nginx欢迎内容，便表明Nginx已正常运行且安装完成。

四、配置Web服务器支持PHP

1. 配置Nginx解析PHP

站点配置可选择新建自定义文件，也可对Nginx默认文件进行编辑：

sudo vi /etc/nginx/conf.d/thinkphp.conf

加入以下内容（将/path/to/your/thinkphp/project替换成项目实际路径）：

server {listen 80;server_name your_domain.com;# 替换为域名或IProot /path/to/your/thinkphp/project/public;# ThinkPHP项目public目录index index.php index.html index.htm;location / {try_files $uri $uri/ /index.php?$query_string;# 路由重写，支持PATHINFO}location ~ .php$ {fastcgi_pass unix:/run/php-fpm/www.sock;# 与PHP-FPM通信fastcgi_index index.php;include fastcgi_params;fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;fastcgi_param PATH_INFO $fastcgi_path_info;}location ~ /.ht {deny all;# 禁止访问.htaccess文件}}

测试Nginx配置语法：
```
sudo nginx -t
```
若输出syntax is ok，则重启Nginx使配置生效：
```
sudo systemctl restart nginx```。
```

五、部署PHP依赖管理工具Composer

ThinkPHP项目通过Composer管理依赖，可按以下步骤安装：

安装Composer依赖：
```
sudo yum install unzip git -y
```

下载并安装Composer：

curl -sS https://getcomposer.org/installer | phpsudo mv composer.phar /usr/local/bin/composer

检查Composer安装：
```
composer --version
```
输出中应显示Composer版本信息。

六、部署ThinkPHP项目

进入项目目录：
```
cd /path/to/your/thinkphp/project
```
使用Composer创建ThinkPHP项目（以ThinkPHP 8.x为例）：
```
composer create-project topthink/think your-project-name
```
也可以把现有项目上传到/path/to/your/thinkphp/project目录中。

配置数据库连接：编辑项目根目录下的.env文件（或config/database.php），修改以下参数：

DB_TYPE=mysqlDB_HOST=127.0.0.1DB_NAME=your_database_nameDB_USER=your_database_userDB_PASSWORD=your_database_passwordDB_PORT=3306DB_PREFIX=tp_# 表前缀（可选）```。

七、完成数据库配置

安装MySQL/MariaDB：
```
sudo yum install mysql-server -y
```

启动MySQL并设置开机自启：

sudo systemctl start mysqldsudo systemctl enable mysqld

获取root用户临时密码：

sudo grep 'temporary password' /var/log/mysqld.log

登录MySQL并修改root密码：

mysql -u root -pALTER USER 'root'@'localhost' IDENTIFIED BY 'YourStrongPassword';# 替换为强密码

创建数据库和用户：

CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;CREATE USER 'your_database_user'@'localhost' IDENTIFIED BY 'your_database_password';GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_database_user'@'localhost';FLUSH PRIVILEGES;

退出MySQL：
```
EXIT;```。
```

八、配置权限并启动项目

设置项目目录权限（避免权限问题导致无法访问）：

sudo chown -R nginx:nginx /path/to/your/thinkphp/project# CentOS 7默认Nginx用户为nginxsudo chmod -R 755 /path/to/your/thinkphp/project

启动ThinkPHP内置服务器（仅开发环境使用）：
```
cd /path/to/your/thinkphp/projectphp think run
```
浏览器访问http://your_server_ip:8000，若看到ThinkPHP欢迎页面则说明部署成功。

九、排查常见问题

502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php-fpm），确认Nginx配置中的fastcgi_pass路径与PHP-FPM监听路径一致（/run/php-fpm/www.sock）。
路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;，且项目public/.htaccess文件未被删除（若使用Apache）。
Composer安装慢：配置国内镜像加速（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。