在Linux上如何使用ThinkPHP进行开发 - 问答

在Linux上使用ThinkPHP进行开发的完整流程

一、环境准备：安装基础组件

ThinkPHP运行需PHP、Web服务器（Nginx/Apache）、数据库（MySQL/MariaDB）、Composer四大组件，以下以Ubuntu/Debian为例说明安装步骤（CentOS/RHEL替换为对应yum命令即可）：

更新系统软件包
```
sudo apt update && sudo apt upgrade -y
```
安装PHP及必要扩展
ThinkPHP 6.x推荐PHP 7.4及以上版本，需安装核心扩展：
```
sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl zip -y
```

安装Web服务器（以Nginx为例）

sudo apt install nginx -y
sudo systemctl start nginx && sudo systemctl enable nginx  # 启动并设置开机自启

安装Composer（PHP依赖管理工具）

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer  # 全局可用

二、安装ThinkPHP：推荐Composer创建项目

通过Composer创建项目可自动解决依赖问题，避免手动下载的麻烦：

cd /var/www/html  # 项目存放目录（需web服务器有读取权限）
composer create-project topthink/think tp6  # "tp6"为项目名称，可自定义

等待安装完成后，项目目录结构会自动生成（包含public入口目录、app应用目录等）。

三、配置Web服务器：支持PHP与路径重写

1. Nginx配置（关键步骤）

创建专属配置文件（避免修改默认配置导致冲突）：

sudo nano /etc/nginx/sites-available/tp6.conf

写入以下内容（需修改root指向项目public目录，这是ThinkPHP的安全要求）：

server {
    listen 80;
    server_name your_domain_or_ip;  # 替换为域名或IP
    root /var/www/html/tp6/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/php8.2-fpm.sock;  # 根据PHP版本调整（如php7.4-fpm.sock）
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;  # 禁止访问.htaccess文件
    }
}

启用配置并重启Nginx：

sudo ln -s /etc/nginx/sites-available/tp6.conf /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置语法（无报错则继续）
sudo systemctl restart nginx

2. Apache配置（可选）

若使用Apache，需启用mod_rewrite模块并配置.htaccess：

sudo a2enmod rewrite
sudo systemctl restart apache2

在项目根目录创建.htaccess文件：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

四、配置数据库：连接应用与数据

创建数据库与用户
登录MySQL，执行以下命令：

CREATE DATABASE tp6_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'tp6_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON tp6_db.* TO 'tp6_user'@'localhost';
FLUSH PRIVILEGES;

修改项目数据库配置
编辑项目根目录下的.env文件（覆盖默认配置）：
```
nano /var/www/html/tp6/.env
```
找到[DATABASE]部分，修改为实际信息：
```
DB_TYPE=mysql
DB_HOST=127.0.0.1
DB_NAME=tp6_db
DB_USER=tp6_user
DB_PASSWORD=your_password
DB_PORT=3306
```

五、设置权限：避免文件访问问题

确保web服务器用户（如www-data）对项目目录有正确权限：

sudo chown -R www-data:www-data /var/www/html/tp6  # 修改所有者
sudo chmod -R 755 /var/www/html/tp6/runtime       # 运行时目录需可写

六、运行项目：开发与测试

启动内置服务器（开发环境专用）
进入项目目录，运行以下命令启动PHP内置服务器（端口8000，仅本地访问）：
```
cd /var/www/html/tp6
php think run
```
浏览器访问http://your_domain_or_ip:8000，若看到ThinkPHP欢迎页面，则说明环境配置成功。
生产环境部署
开发完成后，关闭调试模式（修改config/app.php中的app_debug为false），并通过Nginx/Apache提供正式服务。

七、常见问题排查

502 Bad Gateway：检查PHP-FPM是否运行（sudo systemctl status php-fpm），确认Nginx配置中的fastcgi_pass路径与PHP-FPM的socket路径一致。
路由失效：确保Nginx配置中包含try_files $uri $uri/ /index.php?$query_string;（路径重写是ThinkPHP路由生效的关键）。
Composer安装慢：切换国内镜像加速（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）。

通过以上步骤，即可在Linux系统上完成ThinkPHP的开发环境搭建与项目运行。开发过程中，可通过git进行版本控制，结合CI/CD工具实现自动化部署，提升开发效率。

0 赞

0 踩