WordPress│REST APIで自前のプラグイン更新サーバーを作る仕組み

[クライアントサイト(プラグイン利用者)]
        │
        │ ① 更新チェック（slug + 現在バージョン）
        ▼
[更新サーバー(本プラグイン)]
        │
        │ ② 最新リリース情報 + ZIPダウンロードURL を返す
        ▼
[クライアントサイト]
        │
        │ ③ ダウンロードURLにアクセスしてZIP取得
        ▼
[更新サーバー]
        │
        │ ④ 登録されたZIPをそのまま配信
        ▼
[クライアントサイトが ZIP を解凍してプラグイン更新]

your-update-server/
├── your-update-server.php    # メインファイル（定数・require・有効化フック）
└── inc/
    ├── db.php                # テーブル定義 + ヘルパー関数
    ├── rest.php              # REST APIルート（update / download）
    └── admin.php             # 管理画面（リリース登録・一覧）

function yus_rest_update(\WP_REST_Request $request): \WP_REST_Response
{
    $action = (string) $request->get_param('action');
    $product_slug = sanitize_key((string) $request->get_param('slug'));
    $current_version = (string) $request->get_param('version');

    // 1. パラメータチェック
    if ($product_slug === '') {
        return new \WP_REST_Response(['ok' => false, 'message' => 'Missing slug parameter.'], 400);
    }

    // 2. 最新リリース取得
    $release = yus_get_latest_release($product_slug);
    if (! $release) {
        return new \WP_REST_Response(['ok' => false, 'message' => 'No published release found.'], 404);
    }

    // 3. ダウンロードURLを組み立て
    $package = add_query_arg([
        'rest_route' => '/your-update/v1/download',
        'slug'       => $product_slug,
    ], untrailingslashit(home_url('/')) . '/index.php');

    // 4. plugin_information アクションの場合は詳細情報を返す
    if ($action === 'plugin_information') {
        // ...詳細情報のレスポンス
    }

    // 5. 同じ版以上なら空配列を返す（JSONでは []）
    if ($current_version !== '' && version_compare($release['version'], $current_version, '<=')) {
        return new \WP_REST_Response([], 200);
    }

    // 6. 更新情報を返す
    return new \WP_REST_Response([
        'new_version' => $release['version'],
        'package'     => $package,
        'tested'      => $release['tested_wp'],
        'requires'    => $release['requires_wp'],
        'homepage'    => $release['homepage_url'] ?: home_url('/'),
    ], 200);
}

if ($action === 'plugin_information') {
    return new \WP_REST_Response([
        'name'           => $product_slug,
        'slug'           => $product_slug,
        'version'        => $release['version'],
        'requires'       => $release['requires_wp'],
        'tested'         => $release['tested_wp'],
        'requires_php'   => $release['requires_php'],
        'last_updated'   => $release['updated_at'],
        'download_link'  => $package,
        'package'        => $package,
        'sections'       => [
            'description' => '<p>' . esc_html($product_slug) . '</p>',
            'changelog'   => '<pre>' . esc_html($release['changelog']) . '</pre>',
        ],
    ], 200);
}

function yus_rest_download(\WP_REST_Request $request)
{
    $product_slug = sanitize_key((string) $request->get_param('slug'));
    if ($product_slug === '') {
        return new \WP_REST_Response('Missing slug.', 400);
    }

    $release = yus_get_latest_release($product_slug);
    if (! $release) {
        return new \WP_REST_Response('No published release found.', 404);
    }

    $zip_path = $release['zip_path'];
    if ($zip_path === '' || ! file_exists($zip_path)) {
        return new \WP_REST_Response('Package file not found.', 404);
    }

    // ZIPをそのまま配信
    nocache_headers();
    header('Content-Type: application/zip');
    header('Content-Length: ' . filesize($zip_path));
    header('Content-Disposition: attachment; filename="' . basename($zip_path) . '"');
    readfile($zip_path);
    exit;
}

add_action('rest_api_init', function () {
    register_rest_route('your-update/v1', '/update', [
        'methods'             => 'GET',
        'callback'            => 'yus_rest_update',
        'permission_callback' => '__return_true',
    ]);
    register_rest_route('your-update/v1', '/download', [
        'methods'             => 'GET',
        'callback'            => 'yus_rest_download',
        'permission_callback' => '__return_true',
    ]);
});

if (! preg_match('/^\d+(?:\.\d+)*(?:-[0-9A-Za-z.-]+)?$/', $version)) {
    yus_set_notice('error', 'Version must look like 0.1.3 or 1.0.0-beta.');
    ...
}

function yus_upload_dir(): array
{
    $uploads = wp_upload_dir();
    $base_dir = trailingslashit($uploads['basedir']) . 'yus-releases';
    wp_mkdir_p($base_dir);
    ...
}

<?php
/**
 * Plugin Name: My Plugin
 * Version: 0.1.0
 */

define('MY_PLUGIN_VERSION', '0.1.0');
define('MY_PLUGIN_SLUG', 'my-plugin');
define('MY_PLUGIN_FILE', plugin_basename(__FILE__));
define('MY_PLUGIN_UPDATE_API', 'https://example.com/wp-json/your-update/v1/update');

// 更新チェック
add_filter('pre_set_site_transient_update_plugins', function ($transient) {
    if (! is_object($transient)) {
        return $transient;
    }

    $response = wp_remote_get(add_query_arg([
        'slug'    => MY_PLUGIN_SLUG,
        'version' => MY_PLUGIN_VERSION,
    ], MY_PLUGIN_UPDATE_API));

    if (is_wp_error($response)) {
        return $transient;
    }

    $body = json_decode(wp_remote_retrieve_body($response), true);

    if (! empty($body['new_version']) && version_compare($body['new_version'], MY_PLUGIN_VERSION, '>')) {
        $transient->response[MY_PLUGIN_FILE] = (object) [
            'slug'        => MY_PLUGIN_SLUG,
            'plugin'      => MY_PLUGIN_FILE,
            'new_version' => $body['new_version'],
            'package'     => $body['package'],
            'tested'      => $body['tested'] ?? '',
            'requires'    => $body['requires'] ?? '',
        ];
    }

    return $transient;
});

// プラグイン詳細画面用
add_filter('plugins_api', function ($result, $action, $args) {
    if ($action !== 'plugin_information' || ($args->slug ?? '') !== MY_PLUGIN_SLUG) {
        return $result;
    }

    $response = wp_remote_get(add_query_arg([
        'slug'    => MY_PLUGIN_SLUG,
        'action'  => 'plugin_information',
    ], MY_PLUGIN_UPDATE_API));

    if (is_wp_error($response)) {
        return $result;
    }

    $body = json_decode(wp_remote_retrieve_body($response), true);
    return (object) $body;
}, 10, 3);

wp transient delete update_plugins --network
wp plugin list --update=available --fields=name,version,update_version