ThinkPHP建站教程：PHP开发框架安装配置与Web应用开发指南

ThinkPHP是一款基于PHP开发的开源Web应用开发框架，以Apache2协议开源，完全免费商用。ThinkPHP诞生于2006年，是国内最流行的PHP开发框架之一，以简洁易用、性能优异、文档完善著称。ThinkPHP遵循MVC设计模式，支持ORM、路由、中间件、模板引擎、缓存、验证、多语言等完整功能，适合开发各类Web应用、企业官网、管理后台、API接口、小程序后端。

核心优势：完全开源免费（Apache2协议）、简洁易用的MVC架构、丰富的功能组件（ORM、路由、中间件、缓存、验证等）、出色的性能、完善的中文文档、活跃的国内社区、支持Composer包管理、支持Swoole协程、易于学习上手。ThinkPHP是国内PHP开发者首选的开发框架。

环境要求

• 操作系统：Linux（Ubuntu/Debian/CentOS）、Windows、macOS
• Web服务器：Nginx / Apache / IIS
• PHP版本：PHP 7.2.5+ / PHP 8.0+（ThinkPHP 6.x推荐PHP 7.4+/8.0+；ThinkPHP 8推荐PHP 8.0+）
• 数据库：MySQL 5.6+ / MariaDB / PostgreSQL / SQLite / SQL Server
• 内存：最低256MB，推荐512MB以上
• 磁盘：至少200MB可用空间
• PHP扩展：mbstring、json、openssl、pdo、pdo_mysql、tokenizer、xml、curl、gd（可选）
• Composer：PHP包管理器（必需，用于安装ThinkPHP和扩展）

安装教程

步骤1：安装PHP和Composer

# Ubuntu/Debian
apt update
apt install -y php php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-gd php-zip php-json composer
php --version
composer --version

Windows环境：下载安装PHP（https://windows.php.net/download），安装Composer（https://getcomposer.org/download/），确保php和composer命令可用。

步骤2：创建ThinkPHP项目

cd /www/wwwroot
composer create-project topthink/think yourdomain.com
cd yourdomain.com
# 查看版本
php think version

这会创建一个标准的ThinkPHP 6/8项目结构，包含app、config、public、route、runtime、vendor等目录。

步骤3：配置数据库

编辑 config/database.php 文件：

return [
    'default' => env('db.driver', 'mysql'),
    'connections' => [
        'mysql' => [
            'type' => 'mysql',
            'hostname' => '127.0.0.1',
            'database' => 'thinkphp',
            'username' => 'thinkphp_user',
            'password' => 'your_strong_password',
            'hostport' => '3306',
            'charset' => 'utf8mb4',
            'prefix' => 'tp_',
            'deploy' => 0,
            'rw_separate' => false,
        ],
    ],
];

创建数据库：

mysql -u root -p
CREATE DATABASE thinkphp DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'thinkphp_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON thinkphp.* TO 'thinkphp_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

步骤4：配置目录权限

chown -R www:www /www/wwwroot/yourdomain.com
chmod -R 755 /www/wwwroot/yourdomain.com
chmod -R 777 /www/wwwroot/yourdomain.com/runtime
chmod -R 777 /www/wwwroot/yourdomain.com/public/uploads

步骤5：Nginx配置

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /www/wwwroot/yourdomain.com/public;
    index index.php index.html;

    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=$1 last;
        }
    }

    location ~ \.php$ {
        fastcgi_pass unix:/tmp/php-cgi-80.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # 禁止访问敏感目录
    location ~ /\.ht {
        deny all;
    }
}

注意：网站根目录必须指向public目录，这是ThinkPHP的安全设计。

步骤6：测试运行

本地开发可以使用内置服务器：

php think run

访问 http://localhost:8000 即可看到ThinkPHP欢迎页。

生产环境访问 http://yourdomain.com，应显示ThinkPHP默认欢迎页面。

步骤7：创建控制器和路由（基础开发示例）

创建控制器 app/controller/Index.php：

use think\facade\Route;

Route::get('/', 'Index/index');
Route::get('hello/:name', 'Index/hello');

order('id', 'desc')
            ->paginate(10);
        return json($users);
    }
}