如何 Ubuntu 装 ThinkPHP

下面按在 Ubuntu 上安装并运行 ThinkPHP的完整流程来说明（以 ThinkPHP 6 / 8 为例，PHP 项目通用）。

一、准备环境（Ubuntu）

1. 更新系统

sudo apt update
sudo apt upgrade -y

2. 安装 PHP 及常用扩展

sudo apt install php php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-zip unzip -y

查看 PHP 版本：

php -v

二、安装 Composer（ThinkPHP 必需）

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

验证：

composer -V

三、创建 ThinkPHP 项目

方式一：Composer 安装（推荐）

composer create-project topthink/think tpapp

tpapp 是你的项目目录名

进入目录：

cd tpapp

四、运行 ThinkPHP（开发环境）

使用内置服务器

php think run

默认访问：

http://localhost:8000

或指定端口：

php think run -p 9000

五、使用 Nginx 部署（生产环境推荐）

1. 安装 Nginx

sudo apt install nginx -y

2. 配置 Nginx

新建配置文件：

sudo nano /etc/nginx/sites-available/tpapp

示例配置：

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/tpapp/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/php-fpm.sock;
    }
}

启用站点：

sudo ln -s /etc/var/www/tpapp /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

六、权限设置（重要）

sudo chown -R www-data:www-data tpapp
sudo chmod -R 755 tpapp

七、目录结构说明（重点）

tpapp/
 ├─ app/         # 应用代码
 ├─ public/      # Web 入口（必须指向这里）
 ├─ config/      # 配置
 ├─ runtime/     # 缓存（需可写）

八、常见问题

1. 页面 500

• 检查 runtime 目录权限
• 查看日志：

tail -f tpapp/runtime/log/*

2. 提示扩展缺失

sudo apt install php-xxx

3. 使用 MySQL

sudo apt install mysql-server -y

修改：

config/database.php

九、总结一句话

Ubuntu 装 ThinkPHP = 装 PHP + Composer + 创建项目 + 指向 public 目录

如果你是：

• 新手 → 用 php think run
• 上线 → 用 Nginx + PHP-FPM

需要我给你 一键安装脚本 或 Docker 版 ThinkPHP 吗？