如何利用Debian LAMP完成API接口开发

在 Debian 上用 LAMP 搭建 API 接口

一 环境准备与安装

• 更新系统并安装组件（Debian 12 默认仓库以 MariaDB 为主，兼容 MySQL；如需 MySQL 可按需安装）：
  • 安装 Apache、MariaDB、PHP 及常用扩展：
    • sudo apt update
    • sudo apt install apache2 mariadb-server php libapache2-mod-php php-mysql
  • 启动并开机自启服务：
    • sudo systemctl start apache2 mariadb
    • sudo systemctl enable apache2 mariadb
  • 安全加固数据库（设置 root 密码、移除匿名用户等）：
    • sudo mysql_secure_installation
  • 验证安装：
    • 访问 http://服务器IP 应看到 Apache 默认页
    • 在 /var/www/html 创建 info.php 输出 phpinfo() 验证 PHP
• 说明：Debian 12 官方仓库通常提供 MariaDB 作为 MySQL 的替代；若你明确需要 MySQL，可另行添加 MySQL 官方仓库后安装。

二 数据库与示例数据

• 登录数据库并创建库、用户与表：
  • mysql -u root -p
  • CREATE DATABASE myapi CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • CREATE USER ‘myuser’@‘localhost’ IDENTIFIED BY ‘mypassword’;
  • GRANT ALL PRIVILEGES ON myapi.* TO ‘myuser’@‘localhost’;
  • FLUSH PRIVILEGES;
  • USE myapi;
  • CREATE TABLE users (id INT AUTO_INCREMENT PRIMARY KEY,name VARCHAR(255) NOT NULL,email VARCHAR(255) NOT NULL);
  • INSERT INTO users (name, email) VALUES (‘John Doe’, ‘[email protected]’), (‘Jane Smith’, ‘[email protected]’);
• 以上为后续 API 示例提供数据支撑。

三 编写第一个 API 接口

• 在站点根目录（如 /var/www/html）创建 api.php：
  • <?phpheader('Content-Type: application/json; charset=utf-8');header('Access-Control-Allow-Origin: *');header('Access-Control-Allow-Methods: GET, POST, OPTIONS');header('Access-Control-Allow-Headers: Content-Type');

    $method = $_SERVER[‘REQUEST_METHOD’] ?? ‘GET’;$id = $_GET[‘id’] ?? null;

    // 连接数据库$conn = new mysqli(‘localhost’, ‘myuser’, ‘mypassword’, ‘myapi’);if ($conn->connect_error) {http_response_code(500);echo json_encode([‘error’ => ‘Database connection failed’]);exit;}$conn->set_charset(‘utf8mb4’);

    // 处理请求if ($method === ‘GET’) {if ($id) {$stmt = $conn->prepare(‘SELECT id, name, email FROM users WHERE id = ?’);$stmt->bind_param(‘i’, $id);$stmt->execute();$res = $stmt->get_result();$user = $res->fetch_assoc();echo $user ? json_encode($user) : json_encode([‘error’ => ‘Not found’], JSON_UNESCAPED_UNICODE);} else {$res = $conn->query(‘SELECT id, name, email FROM users ORDER BY id DESC’);echo json_encode($res->fetch_all(MYSQLI_ASSOC));}} elseif ($method === ‘POST’) {$input = json_decode(file_get_contents(‘php://input’), true);$name= trim($input[‘name’] ?? ‘’);$email = trim($input[‘email’] ?? ‘’);if (!$name || !$email || !filter_var($email, FILTER_VALIDATE_EMAIL)) {http_response_code(400);echo json_encode([‘error’ => ‘Invalid input’]);exit;}$stmt = $conn->prepare(‘INSERT INTO users (name, email) VALUES (?, ?)’);$stmt->bind_param(‘ss’, $name, $email);if ($stmt->execute()) {http_response_code(201);echo json_encode([‘id’ => $conn->insert_id, ‘name’ => $name, ‘email’ => $email]);} else {http_response_code(500);echo json_encode([‘error’ => ‘Insert failed’]);}} else {http_response_code(405);echo json_encode([‘error’ => ‘Method not allowed’]);}$conn->close();?>

• 测试：
  • GET 单条：curl -i “http://服务器IP/api.php?id=1”
  • GET 列表：curl -i “http://服务器IP/api.php”
  • POST 新增：curl -i -X POST -H “Content-Type: application/json” -d ‘{“name”:“Tom”,“email”:“[email protected]”}’ http://服务器IP/api.php
• 要点：使用 预处理语句 防止 SQL 注入；统一输出 JSON；设置 CORS 便于前端跨域调用。

四 安全与优化

• 输入校验与输出编码：对所有输入进行类型、长度、格式校验；输出统一用 json_encode，避免直接输出未过滤数据。
• 错误处理：生产环境避免泄露堆栈与敏感信息，统一返回错误码与简洁消息。
• 身份认证与授权：为接口增加 API Key 或 JWT 校验；对敏感操作使用更严格的权限控制。
• 数据库安全：最小权限原则、强口令、限制数据库端口访问、定期备份。
• 性能优化：为高频查询字段建立 索引；合理使用 缓存（如 Redis/Memcached）；开启 OPcache；静态资源使用 CDN。
• Web 服务器与 PHP 调优：启用 HTTP/2、压缩（mod_deflate/gzip）、长连接；调整 PHP-FPM 进程模型与内存限制；分离静态资源与动态接口路径。

五 进阶方案与部署

• 使用框架提升效率与可维护性：
  • 在 Debian 上安装 PHP Composer，创建 Laravel 项目，配置 Nginx/PHP-FPM，通过 Artisan 生成控制器与 API 路由，内置 Eloquent ORM、验证、分页、资源路由等，适合中大型 API 项目。
• 文档与规范：
  • 结合 OpenAPI/Swagger 生成在线接口文档，便于前后端协作与自动化测试；在 Debian 上可通过相应工具链集成 Swagger UI 或生成规范文件。
• 部署与运维：
  • 使用 systemd 管理 Apache/PHP-FPM；配置 Let’s Encrypt 免费证书启用 HTTPS；对外仅暴露 80/443；设置 防火墙（UFW） 放行必要端口；日志集中与监控报警。