Ubuntu系统下ThinkPHP API接口开发实战指南

在Ubuntu上搭建ThinkPHP API开发环境：从零到一的实战指南

想在Ubuntu系统里用ThinkPHP框架快速搭建起API服务？这事儿其实没想象中那么复杂。下面这份手把手的流程，能帮你清晰地走通从环境配置到接口测试的每一个环节。

第一步：打好基础——安装PHP环境

一切的前提，是确保你的Ubuntu系统已经准备好了PHP。如果还没安装，打开终端，执行下面这组命令，就能把PHP核心及其开发API常用的扩展一并搞定：

sudo apt update
sudo apt install php php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath

第二步：引入管家——安装Composer

现代PHP项目离不开依赖管理，Composer正是这个领域的标准工具。通过下面两条命令，你可以轻松地将Composer安装到系统全局路径：

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

第三步：创建项目骨架——初始化ThinkPHP

环境就绪后，就可以请出今天的主角——ThinkPHP了。使用Composer的`create-project`命令，能直接拉取最新的框架代码并创建项目结构：

composer create-project topthink/think=latest-project-name

注意，记得把命令末尾的latest-project-name替换成你实际想用的项目名称。

第四步：配置通道——设置Web服务器

要让外界能访问到你的API，需要配置一个Web服务器，Nginx或Apache都可以。这里以Nginx为例，给出一个典型的配置片段：

server {
    listen 80;
    server_name your_domain.com;
    root /path/to/your/project;
    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 关键点：根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

配置中有两个地方需要你亲自修改：一是your_domain.com，换成你的域名或服务器IP；二是/path/to/your/project

第五步：启动服务——运行Nginx

sudo systemctl start nginx
sudo systemctl enable nginx

namespace app\controller;

use think\Controller;
use think\Request;

class ApiController extends Controller
{
    public function index(Request $request)
    {
        return json(['message' => 'Hello, World!']);
    }

    public function getUser(Request $request)
    {
        $id = $request->param('id');
        // 这里模拟根据$id查询用户信息的逻辑
        $user = ['id' => $id, 'name' => 'John Doe'];
        return json($user);
    }
}

curl http://your_domain.com/api/getUser?id=1