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

Object Storage Service:インストール

最終更新日:Feb 28, 2025

Object Storage Service (OSS) バケットの管理、オブジェクトのアップロードとダウンロード、データの管理、および画像処理 (IMG) を実行する場合は、最初に PHP 用 OSS SDK をインストールします。このトピックでは、さまざまな方法を使用して PHP 用 OSS SDK をインストールする方法について説明します。要件に基づいて適切なインストール方法を選択できます。

準備

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

  • 環境要件

    PHP と cURL 拡張機能をインストールする必要があります。

    • Windows に PHP と cURL 拡張機能をインストールする方法の詳細については、「Windows で Alibaba Cloud OSS PHP SDK をコンパイルして使用する」をご参照ください。指定されたモジュールが使用できないことを示すメッセージが表示された場合は、php.ini ファイルで extension_dir を C:/Windows/System32/ に設定します。

    • Ubuntu では、sudo apt-get install php-curl コマンドを実行して、apt-get を使用して PHP の cURL 拡張機能をインストールします。

    • CentOS では、sudo yum install php-curl コマンドを実行して、YUM を使用して PHP の cURL 拡張機能をインストールします。

  • PHP バージョンと cURL 拡張機能のチェック

    • php -v コマンドを実行して、現在の PHP バージョンを表示します。

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

PHP 用 OSS SDK のダウンロード

詳細については、「API ドキュメント」をご参照ください。

説明

最新バージョンの SDK を使用することをお勧めします。 2.0.0 より前の PHP 用 OSS SDK をダウンロードするには、ダウンロード をクリックします。

PHP 用 OSS SDK のインストール

次のいずれかの方法を使用して、PHP 用 OSS 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 config -g repositories.packagist composer http://packagist.phpcomposer.com コマンドを実行して、Composer 中国の イメージソース を使用できます。

  • 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 を使用して PHP 用 OSS SDK をインストールすると、接続の問題が発生し、必要な依存関係を Composer を使用してダウンロードできません。

原因

デフォルトでは、Composer は HTTP 経由の接続を拒否するように構成されています。データセキュリティを確保するために、すべての接続で HTTPS を使用する必要があります。これにより、データ転送のセキュリティが向上し、機密データの漏洩や改ざんを防ぎます。

解決策

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

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

composer config secure-http false

HTTPS を無効にすると、データセキュリティが損なわれることに注意してください。安全な接続には HTTPS を使用することをお勧めします。