すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:インストール (PHP SDK V1)

最終更新日:Sep 12, 2026

OSS PHP SDK をインストールすると、OSS バケットの管理、ファイルのアップロードとダウンロード、データ管理、または画像処理を実行できます。このトピックでは、OSS PHP SDK をインストールする複数のメソッドについて説明します。シナリオに最適なメソッドを選択できます。

前提条件

OSS PHP SDK には PHP 5.3 以降が必要です。このトピックでは、例として PHP 5.6.22 を使用します。

  • インストール環境

    PHP と cURL 拡張をインストールします。

    • Windows では、PHP と cURL 拡張をインストールしてください。 "module not found" エラーが発生した場合は、php.ini ファイルで extension_dir を C:/Windows/System32/ に設定してください。

    • Ubuntu では、apt-get パッケージマネージャーを使用して PHP 用の cURL 拡張をインストールできます:sudo apt-get install php-curl。

    • CentOS では、yum パッケージマネージャーを使用して PHP 用の cURL 拡張をインストールできます:sudo yum install php-curl。

  • バージョンの確認

    • php -v コマンドを実行して、PHP のバージョンを確認します。

    • php -m コマンドを実行して、cURL 拡張がインストールされているかどうかを確認します。

SDK のダウンロード

詳細については、「OSS API documentation」をご参照ください。

説明

SDK は、最新バージョンを使用することを推奨します。2.0.0 より前の OSS PHP SDK のドキュメントは、こちらからダウンロードできます。

SDK のインストール

次のいずれかのメソッドを使用して SDK をインストールできます。

  • Composer の使用

    1. プロジェクトのルートディレクトリで composer require aliyuncs/oss-sdk-php コマンドを実行するか、composer.json ファイルに次の依存関係を追加します。

      
      "require": {
          "aliyuncs/oss-sdk-php": "~2.4"
      }
                                  
    2. composer install コマンドを実行して依存関係をインストールします。インストールが完了すると、ディレクトリ構造は次のようになります。

              .
              ├── src
              |   └──app.php
              ├── composer.json
              ├── composer.lock
              └── vendor
                                  

      この構造では、app.php はアプリケーションファイルで、vendor/ フォルダーに依存関係が含まれています。app.php ファイルに次の行を追加します:

      require_once __DIR__ . '/../vendor/autoload.php';
                                  
    説明
    • プロジェクトに autoload.php への参照がすでに含まれている場合、再度追加する必要はありません。

    • Composer の使用時にネットワークエラーが発生する場合は、中国リージョン向けの Composer ミラーを使用できます。これを行うには、コマンドラインで次のコマンドを実行してください:composer config -g repositories.packagist composer http://packagist.phpcomposer.com。

  • PHAR ファイルの使用

    1. GitHub で必要なバージョンを選択し、パッケージ化された PHAR ファイルをダウンロードします。

    2. コードで PHAR ファイルを参照します。

      require_once '/path/to/oss-sdk-php.phar';
                                  
  • ソースコードの使用

    1. GitHub で必要なバージョンを選択し、ソースコードパッケージ (ZIP ファイル) をダウンロードします。

    2. 解凍したパッケージのルートディレクトリには、autoload.php ファイルが含まれています。コードにこのファイルへの参照を含めます:

      require_once '/path/to/oss-sdk/autoload.php';

よくある質問

エラー:Your configuration does not allow connection

完全なエラーメッセージ

Your configuration does not allow connection to http://packagist.phpcomposer.com/packages.json. See https://getcomposer.org/doc/06-config.md#secure-http for details

症状

Composer を使用して SDK をインストールする際に接続エラーが発生し、必要な依存関係をダウンロードできません。

原因

デフォルトでは、Composer の設定により HTTP 経由の接続が禁止されています。セキュリティ上の理由から、すべての接続で HTTPS を使用する必要があります。この運用により、データ転送の安全性が確保され、機密情報の漏えいや改ざんを防止できます。

解決策

特定の内部ネットワーク環境などで、HTTP 経由で依存関係をダウンロードする必要がある場合は、Composer の設定を調整して HTTP 接続を許可できます。

プロジェクトのルートディレクトリで、次のコマンドを実行して Composer が HTTP 接続を許可するように設定してください:

composer config secure-http false

HTTPS を無効化するとセキュリティが低下します。HTTPS を利用できる環境では、安全な接続を優先してください。