告别繁琐的手动部署：如何使用LaravelForgeSDK自动化你的服务器管理

碧海醫心

发布时间：2025-09-29 13:22:32

660人浏览过

来源于php中文网

原创

告别繁琐的手动部署：如何使用laravelforgesdk自动化你的服务器管理

Composer在线学习地址：学习地址

告别繁琐的手动部署：Laravel Forge SDK 助你实现服务器管理自动化

作为一名 PHP 开发者，尤其是 Laravel 开发者，我们可能都对 Laravel Forge 不陌生。它是一个强大的服务器配置和部署服务，极大地简化了服务器管理。然而，即使有了 Forge，当项目数量增多，或者需要频繁地进行部署、创建新站点、管理数据库等操作时，手动登录 Forge 后台，一步步点击，依然会成为一个耗时且容易出错的痛点。

想象一下这样的场景：

你需要为多个客户快速部署相似的 Laravel 应用。
你的 CI/CD 流程需要自动创建测试环境或部署到生产环境。
你希望通过自定义脚本来批量管理服务器上的特定服务（如重启 Nginx、更新 PHP 版本）。

这些重复性的工作不仅耗费大量精力，还可能因为人为操作失误导致生产事故。我们渴望一种更高效、更自动化的方式来与 Forge 互动，将服务器管理融入到我们的开发工作流中。

Composer 登场：轻松集成 Forge SDK

幸运的是，Laravel 官方提供了一个强大的工具来解决这个问题——Laravel Forge SDK。而要将这个 SDK 引入到我们的项目中，Composer 再次扮演了关键角色。

Composer 是 PHP 的一个依赖管理工具，它让我们可以轻松地声明项目所依赖的库，并自动为我们安装和管理这些库。通过 Composer，集成 laravel/forge-sdk 变得异常简单：

composer require laravel/forge-sdk

只需一行命令，Composer 就会下载并安装 Forge SDK 及其所有依赖，并自动生成 autoload 文件，让你可以立即在代码中使用它。这极大地降低了集成第三方库的门槛，让我们能够专注于业务逻辑，而不是繁琐的依赖管理。

自动化你的 Forge 操作：Forge SDK 实战

安装完成后，我们就可以开始使用 Forge SDK 来自动化各种服务器管理任务了。

1. 初始化 Forge 客户端

首先，你需要从 Forge 官方网站获取你的 API Token，然后用它来初始化 SDK：

2. 获取服务器列表

现在，你可以轻松地获取你在 Forge 上管理的所有服务器：

Bandy AI

全球领先的电商设计Agent

下载

servers();

echo "你的 Forge 服务器列表：\n";
foreach ($servers as $server) {
    echo "  - ID: {$server->id}, 名称: {$server->name}, IP: {$server->ipAddress}, 区域: {$server->region}\n";
}
?>

通过几行代码，你就获取了所有服务器的详细信息，这比手动登录后台查看要快得多！

3. 自动化创建新服务器和站点

这是 Forge SDK 最强大的应用场景之一。你可以编写脚本来自动创建新服务器、配置环境、部署站点。告别手动点击的繁琐，实现真正的“一键部署”！

createServer([
        "provider"      => ServerProviders::DIGITAL_OCEAN,
        "credential_id" => 12345, // 替换为你在 Forge 中配置的 DigitalOcean 凭据 ID
        "name"          => "my-automated-app-server",
        "type"          => ServerTypes::APP,
        "size"          => "s-1vcpu-1gb", // DigitalOcean 的服务器大小
        "database"      => "mysql",
        "database_type" => InstallableServices::MYSQL,
        "php_version"   => InstallableServices::PHP_83, // 或其他你需要的版本
        "region"        => "nyc1" // 纽约数据中心
    ]);

    echo "服务器 '{$newServer->name}' (ID: {$newServer->id}) 已开始配置。Forge 将需要几分钟完成。\n";

    // 注意：createServer 方法默认不会等待服务器完全就绪。
    // 你可以通过 $newServer->isReady 属性或定期检查来确认。
    // 如果需要等待，可以这样：
    // $forge->setTimeout(300)->createServer([...]); // 设置更长的超时时间并等待

    // 假设服务器 ID 已知，接下来可以创建站点
    $serverId = $newServer->id; // 或者你已经存在的服务器ID

    echo "正在为服务器 {$serverId} 创建新站点...\n";
    $newSite = $forge->createSite($serverId, [
        "domain"      => "my-automated-app.com",
        "project_type" => "php",
        "directory"   => "/public",
        "php_version" => InstallableServices::PHP_83,
        "repo"        => "your-github-username/your-repo-name", // 你的 Git 仓库
        "branch"      => "main",
        "wait"        => true // 默认会等待站点安装完成，最长30秒
    ]);

    echo "站点 '{$newSite->domain}' (ID: {$newSite->id}) 已创建并部署成功！\n";

    // 触发部署
    // $forge->deploySite($serverId, $newSite->id);
    // echo "已触发站点部署。\n";

} catch (\Exception $e) {
    echo "操作失败: " . $e->getMessage() . "\n";
}
?>

注意：在实际应用中，YOUR_FORGE_API_TOKEN、credential_id、repo、branch 等需要替换为你的实际值。createServer 默认不会等待服务器完全就绪，而 createSite 默认会等待。你可以通过设置 wait 参数或 setTimeout 方法来控制这些行为。