全部产品
Search
文档中心

Object Storage Service:Instalasi (PHP SDK V1)

更新时间:Nov 30, 2025

Instal OSS PHP SDK untuk mengelola bucket OSS, mengunggah dan mengunduh file, mengelola data, atau melakukan pemrosesan gambar. Topik ini menjelaskan beberapa cara menginstal OSS PHP SDK. Anda dapat memilih metode yang paling sesuai dengan skenario Anda.

Prasyarat

OSS PHP SDK memerlukan PHP 5.3 atau versi yang lebih baru. Topik ini menggunakan PHP 5.6.22 sebagai contoh.

  • Lingkungan instalasi

    Instal PHP dan ekstensi cURL:

    • Pada Windows, lihat Kompilasi dan penggunaan Alibaba Cloud OSS PHP SDK di Windows untuk menginstal PHP dan ekstensi cURL. Jika muncul error "module not found", atur `extension_dir` ke C:/Windows/System32/ dalam file php.ini.

    • Pada Ubuntu, Anda dapat menggunakan manajer paket apt-get untuk menginstal ekstensi cURL untuk PHP: sudo apt-get install php-curl.

    • Pada CentOS, Anda dapat menggunakan manajer paket yum untuk menginstal ekstensi cURL untuk PHP: sudo yum install php-curl.

  • Periksa versi

    • Jalankan perintah php -v untuk memeriksa versi PHP.

    • Jalankan perintah php -m untuk memeriksa apakah ekstensi cURL telah diinstal.

Unduh SDK

Untuk informasi selengkapnya, lihat dokumentasi API OSS.

Catatan

Kami menyarankan Anda menggunakan versi SDK terbaru. Anda dapat mengunduh dokumentasi untuk versi OSS PHP SDK sebelum 2.0.0 dari sini.

Instal SDK

Anda dapat menginstal SDK menggunakan salah satu metode berikut:

  • Menggunakan Composer

    1. Jalankan perintah composer require aliyuncs/oss-sdk-php di direktori root proyek Anda, atau tambahkan dependensi berikut ke file composer.json Anda.

      
      "require": {
          "aliyuncs/oss-sdk-php": "~2.4"
      }
                                  
    2. Jalankan perintah composer install untuk menginstal dependensi. Setelah instalasi selesai, struktur direktori adalah sebagai berikut:

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

      Dalam struktur ini, app.php adalah file aplikasi Anda dan folder vendor/ berisi dependensi. Tambahkan baris berikut ke file app.php Anda:

      require_once __DIR__ . '/../vendor/autoload.php';
                                  
    Catatan
    • Jika proyek Anda sudah menyertakan referensi ke autoload.php, Anda tidak perlu menambahkannya lagi.

    • Jika terjadi error jaringan saat menggunakan Composer, Anda dapat menggunakan mirror Composer untuk wilayah Tiongkok. Untuk melakukannya, jalankan perintah berikut di command line: composer config -g repositories.packagist composer http://packagist.phpcomposer.com.

  • Menggunakan file PHAR

    1. Dari GitHub, pilih versi yang diperlukan dan unduh file PHAR yang telah dikemas.

    2. Sertakan referensi ke file PHAR tersebut dalam kode Anda:

      require_once '/path/to/oss-sdk-php.phar';
                                  
  • Menggunakan kode sumber

    1. Dari GitHub, pilih versi yang diperlukan dan unduh paket kode sumber (file ZIP).

    2. Direktori root dari paket yang diekstrak berisi file autoload.php. Sertakan referensi ke file ini dalam kode Anda:

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

FAQ

Kesalahan: Konfigurasi Anda tidak mengizinkan koneksi

Pesan error lengkap

Konfigurasi Anda tidak mengizinkan koneksi ke http://packagist.phpcomposer.com/packages.json. Lihat https://getcomposer.org/doc/06-config.md#secure-http untuk detail lebih lanjut.

Gejala

Saat Anda menggunakan Composer untuk menginstal SDK, terjadi error koneksi sehingga Anda tidak dapat mengunduh dependensi yang diperlukan.

Penyebab

Secara default, konfigurasi Composer melarang koneksi melalui HTTP. Untuk alasan keamanan, semua koneksi harus menggunakan HTTPS. Praktik ini memastikan keamanan transmisi data serta mencegah kebocoran atau manipulasi informasi sensitif.

Solusi

Untuk mengunduh dependensi melalui HTTP, misalnya di lingkungan jaringan internal tertentu, Anda dapat menyesuaikan konfigurasi Composer agar mengizinkan koneksi HTTP.

Di direktori root proyek Anda, jalankan perintah berikut untuk mengonfigurasi Composer agar mengizinkan koneksi HTTP:

composer config secure-http false.

Perlu diperhatikan bahwa menonaktifkan HTTPS mengurangi tingkat keamanan. Utamakan koneksi aman di lingkungan yang mendukung HTTPS.