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

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

最終更新日:Nov 30, 2025

OSS PHP SDK をインストールすると、OSS バケットの管理、ファイルのアップロードとダウンロード、データ管理、画像処理などを行うことができます。この Topic では、OSS PHP SDK をインストールするための複数の方法を説明します。ご利用のシナリオに最も適した方法を選択してください。

前提条件

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

  • インストール環境

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

    • Windows の場合、「Windows で Alibaba Cloud OSS PHP SDK をコンパイルして使用する」をご参照のうえ、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 ドキュメント」をご参照ください。

説明

最新バージョンの 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';

よくある質問

エラー: 設定で接続が許可されていません

完全なエラーメッセージ

構成では http://packagist.phpcomposer.com/packages.json への接続が許可されていません。詳細については、https://getcomposer.org/doc/06-config.md#secure-http を参照してください。

症状

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

原因

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

ソリューション

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

プロジェクトのルートディレクトリで、次のコマンドを実行して、Composer が HTTP 接続を許可するように構成します。

composer config secure-http false

HTTPS を無効にするとセキュリティが低下することにご注意ください。HTTPS が利用可能な環境では、安全な接続を優先してください。