PHP SDK - Tablestore - Tablestore - Alibaba Cloud Documentation Center

Tablestore SDK untuk PHP mendukung operasi model wide column.

Quick start

Mulai menggunakan Tablestore SDK untuk PHP dengan menyiapkan lingkungan, menginstal SDK, dan menginisialisasi klien.

Prepare the environment

PHP 64-bit versi 5.5 atau lebih baru telah diinstal. Jalankan php -v untuk memeriksa versi PHP Anda.

Catatan
Bilangan bulat (integer) Tablestore berbasis 64-bit. PHP 32-bit hanya dapat merepresentasikan bilangan bulat 64-bit sebagai nilai string, sehingga tidak didukung. Di Windows, versi PHP sebelum PHP 7 tidak menggunakan bilangan bulat 64-bit yang sebenarnya. Lakukan upgrade ke PHP 7 atau versi yang lebih baru untuk mendapatkan dukungan bilangan bulat 64-bit yang tepat dan performa yang lebih baik.
Jika Anda menggunakan HTTPS, instal ekstensi OpenSSL untuk PHP.
Alat pengembangan PHP telah diinstal, seperti Eclipse for PHP.
Ekstensi CURL direkomendasikan. Jalankan php -m untuk memeriksa apakah ekstensi CURL telah diinstal.

Install the SDK

Instal Tablestore SDK untuk PHP menggunakan Composer atau dari paket sumber.

Composer

Untuk menginstal SDK dengan Composer, ikuti langkah-langkah berikut:

Jalankan composer require aliyun/aliyun-tablestore-sdk-php di direktori root proyek, atau deklarasikan dependensi Tablestore SDK untuk PHP dalam file composer.json.
```
{
    "require": {
        "aliyun/aliyun-tablestore-sdk-php": "^5.1"
    }
}
```
Jalankan composer install untuk menginstal dependensi. Setelah instalasi selesai, struktur direktorinya adalah:
```
 .
 ├── app.php
 ├── composer.json
 ├── composer.lock
 └── vendor
```
Dalam struktur ini, app.php adalah aplikasi Anda dan direktori vendor/ berisi library yang diperlukan. Sertakan dependensi tersebut di app.php:
```
require_once __DIR__ . '/vendor/autoload.php';
```
Catatan
Jika proyek Anda sudah menyertakan autoload.php, Anda tidak perlu menyertakannya lagi setelah menambahkan dependensi SDK.

Source package

Unduh paket sumber dari salah satu sumber berikut:

Buka GitHub, pilih versi yang Anda butuhkan, lalu unduh arsip sumbernya.
Unduh paket sumber SDK.

Tablestore SDK untuk PHP menyediakan program contoh yang mencakup operasi umum model wide column. Dapatkan program contoh tersebut dengan salah satu cara berikut:

Unduh dan ekstrak paket Tablestore SDK untuk PHP, lalu temukan program contoh di direktori examples.
Kunjungi repositori GitHub Tablestore SDK untuk PHP di aliyun-tablestore-php-sdk.

Configure access credentials

Buat AccessKey untuk Akun Alibaba Cloud Anda atau Pengguna RAM. Kemudian, konfigurasikan AccessKey tersebut dalam variabel lingkungan seperti yang ditunjukkan di bawah. Mengonfigurasi AccessKey dalam variabel lingkungan meningkatkan keamanan karena mencegah penyematan informasi sensitif secara langsung di dalam kode.

Setelah konfigurasi selesai, Anda harus me-restart atau me-refresh lingkungan pengembangan Anda, termasuk IDE, command-line interface, aplikasi desktop lainnya, dan layanan latar belakang, agar variabel lingkungan sistem terbaru dimuat. Untuk informasi lebih lanjut tentang jenis kredensial akses lainnya, lihat Configure access credentials.

Linux

Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.bashrc.

echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.bashrc
```
Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

macOS

Jalankan perintah berikut di terminal untuk melihat jenis shell default Anda.
```
echo $SHELL
```
Lakukan langkah-langkah berikut berdasarkan jenis shell default Anda.
Zsh
1. Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.zshrc.
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc
```
2. Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.zshrc
```
3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```
Bash
1. Jalankan perintah berikut untuk menambahkan pengaturan variabel lingkungan ke file ~/.bash_profile.
```
echo "export TABLESTORE_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile
echo "export TABLESTORE_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile
```
2. Jalankan perintah berikut untuk menerapkan perubahan.
```
source ~/.bash_profile
```
3. Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET
```

Windows

CMD

Jalankan perintah berikut di Command Prompt (CMD) untuk mengatur variabel lingkungan.

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Restart CMD dan jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.
```
echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%
```

PowerShell

Jalankan perintah berikut di PowerShell.

[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

Jalankan perintah berikut untuk memverifikasi bahwa variabel lingkungan telah aktif.

[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::GetEnvironmentVariable("TABLESTORE_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

Initialize a client

Inisialisasi klien Tablestore, lalu daftar tabel dalam instans untuk memverifikasi koneksi.

Penting

Akses jaringan publik dinonaktifkan secara default untuk instans baru. Untuk mengakses sumber daya instans melalui jaringan publik, aktifkan akses publik di Network Management instans tersebut.

require_once __DIR__ . '/vendor/autoload.php';

use Aliyun\OTS\OTSClient as OTSClient;

// yourInstanceName 填写实例名称
$instanceName = "yourInstanceName";
// yourEndpoint 填写实例访问地址
$endpoint = "yourEndpoint";
// 获取系统变量里的 AccessKey ID 和 AccessKey Secret
$accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
$accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');

// 初始化 Tablestore Client
$client = new OTSClient(array(
    'EndPoint' => $endpoint,
    'AccessKeyID' => $accessKeyId,
    'AccessKeySecret' => $accessKeySecret,
    'InstanceName' => $instanceName,
));

// 列出实例中的数据表列表并打印到控制台
$response = $client->listTable (array ());
print json_encode ($response);

Version compatibility

Versi terbaru adalah 5.x.x. Berikut tingkat kompatibilitasnya dengan versi sebelumnya:

Kompatibel dengan SDK 4.x.x.
Tidak kompatibel dengan SDK 2.x.x.

Untuk riwayat versi SDK, lihat PHP SDK historical versions.

FAQ

References

Untuk informasi mengenai penanganan error di Tablestore, lihat Error handling.