如何在Linux上用PHP构建API接口

在Linux上用PHP搭建API接口，这事儿其实没想象中那么复杂。很多新手朋友一上来就想着用框架，其实从零开始手撸一个简单的接口，反而能让你更清楚整个流程的来龙去脉。下面我们就一步步把它拆开来看。

1. 安装PHP

首先，确保你的Linux系统上已经装了PHP。用包管理器是最直接的方式。比如在Ubuntu上，敲下面这条命令就行：

sudo apt update
sudo apt install php php-cli php-mysql

如果你用的是其他发行版，比如CentOS，换成yum或dnf就好。装完之后可以用 php -v 验证一下版本。

2. 创建一个简单的PHP文件

接下来，新建一个PHP文件，就叫 api.php 吧，把下面这段代码放进去：

 'Hello, World!',
    'status' => 'success'
];

// 输出JSON数据
echo json_encode($data);
?>

这段代码做的事情很简单：告诉客户端返回的是JSON格式，然后输出一个固定的数据。你可以把它当成API的“Hello World”版本。

3. 配置Web服务器

PHP文件写好了，还得有个服务器把它跑起来。Apache和Nginx都可以，这里以Apache为例说说配置。

Apache配置

1. 先启用必要的模块：

sudo a2enmod rewrite

2. 然后创建一个虚拟主机配置文件：

sudo nano /etc/apache2/sites-a vailable/api.conf

3. 把下面这个配置填进去：

    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/html/api
    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    
    ErrorLog ${APACHE_LOG_DIR}/api_error.log
    CustomLog ${APACHE_LOG_DIR}/api_access.log combined

4. 启用这个站点：

sudo a2ensite api.conf

5. 最后重启Apache：

sudo systemctl restart apache2

如果要用Nginx，配置思路类似，只是写法不同，这里不展开。

4. 测试API接口

配置完服务器，就可以测试了。最简单的办法是直接在浏览器里访问：http://your_server_ip/api.php。你应该会看到这样一段JSON：

{"message":"Hello, World!","status":"success"}

当然，用命令行工具 curl 更符合API测试的“专业姿势”：

curl http://your_server_ip/api.php

返回结果一样。如果出错了，先检查Apache日志，大多数问题都能在那里找到线索。

5. 添加更多的API功能

一个只会返回固定数据的API显然不够用。实际开发中，你需要根据请求方法（GET、POST等）做不同的处理。下面这个例子演示了如何区分GET和POST：

 'This is a GET request.',
        'status' => 'success'
    ];
} elseif ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $data = [
        'message' => 'This is a POST request.',
        'status' => 'success',
        'received_data' => $_POST
    ];
}

echo json_encode($data);
?>

可以看到，POST请求下还把客户端传来的数据原样返回了，这在调试时非常有用。当然，真实场景里你肯定要对输入做验证和过滤，这里只是演示逻辑。

6. 安全性和性能优化

API写好了，能跑了，但离生产环境还有距离。有几个点值得注意：

• 使用HTTPS：数据在传输过程中必须加密，否则用户名密码之类的敏感信息就是裸奔。
• 身份验证：别让任何人都能调用你的API。JWT、OAuth2都是常见的方案。
• 缓存：对频繁请求且不常变化的数据，用Redis或Memcached做一层缓存，能显著降低服务器压力。
• 输入验证：永远不要信任客户端传过来的数据。过滤、转义、参数化查询，一个都不能少，不然SQL注入分分钟教你做人。

按照以上步骤，你已经能在Linux上用PHP搭建出一个可用的API接口了。剩下的，就是根据业务需求不断迭代和优化——毕竟，一个真正的API之路，才刚刚开始。