Kit SDK PHP - Tablestore - Tablestore - Centre de documentation Alibaba Cloud

Démarrage rapide

Préparez votre environnement, installez le kit SDK et initialisez un client.

Préparation de l'environnement

PHP 5.5 ou version ultérieure en 64 bits. Exécutez php -v pour vérifier votre version.

Remarque
Tablestore utilise des entiers 64 bits. PHP 32 bits ne peut les représenter que sous forme de valeurs string et n'est pas pris en charge. Sous Windows, les versions de PHP antérieures à la version 7 ne prennent pas correctement en charge les entiers 64 bits. Utilisez PHP 7 ou une version ultérieure.
Si vous utilisez HTTPS, installez l'extension PHP OpenSSL.
Un IDE PHP tel qu'Eclipse for PHP.
L'extension cURL (recommandée). Exécutez php -m pour vérifier l'installation.

Installation du kit SDK

Installez le kit SDK avec Composer ou à partir d'un package source.

Composer

Pour installer avec Composer :

Exécutez composer require aliyun/aliyun-tablestore-sdk-php dans la racine du projet, ou ajoutez la dépendance au fichier composer.json.
```
{
    "require": {
        "aliyun/aliyun-tablestore-sdk-php": "^5.1"
    }
}
```
Exécutez composer install. Voici la structure de répertoire résultante :
```
 .
 ├── app.php
 ├── composer.json
 ├── composer.lock
 └── vendor
```
Le répertoire vendor/ contient les bibliothèques installées. Incluez l'autoloader dans votre application :
```
require_once __DIR__ . '/vendor/autoload.php';
```
Remarque
Ignorez cette étape si votre projet inclut déjà autoload.php.

Package source

Téléchargez le package source :

Accédez à GitHub et téléchargez la version dont vous avez besoin.
Téléchargez le package source du kit SDK.

Le kit SDK comprend des exemples de programmes pour les opérations courantes sur le modèle de colonnes larges :

Téléchargez et extrayez le package du kit SDK. Les exemples se trouvent dans le répertoire examples.
Parcourez le dépôt GitHub aliyun-tablestore-php-sdk.

Configuration des identifiants d'accès

Créez un AccessKey pour votre compte Alibaba Cloud ou utilisateur RAM, puis configurez-le comme variable d'environnement pour éviter d'encoder les identifiants en dur.

Redémarrez votre IDE, terminal, autres applications de bureau et services en arrière-plan après la configuration pour charger les variables d'environnement mises à jour. Pour plus d'informations sur les autres types d'identifiants d'accès, consultez Configuration des identifiants d'accès .

Linux

Ajoutez les variables d'environnement à ~/.bashrc :

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

Appliquez les modifications :
```
source ~/.bashrc
```

Vérifiez les variables d'environnement :

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

Vérifiez votre shell par défaut :
```
echo $SHELL
```

Configurez selon le type de votre shell :

Zsh

Ajoutez les variables d'environnement à ~/.zshrc :

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

Appliquez les modifications :
```
source ~/.zshrc
```

Vérifiez les variables d'environnement :

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Bash

Ajoutez les variables d'environnement à ~/.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

Appliquez les modifications :
```
source ~/.bash_profile
```

Vérifiez les variables d'environnement :

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD

Définissez les variables d'environnement dans CMD :

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Redémarrez CMD et vérifiez :

echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%

PowerShell

Exécutez dans 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)

Vérifiez les variables d'environnement :

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

Initialisation d'un client

Initialisez un client Tablestore et listez les tables pour vérifier la connexion.

Important

L'accès au réseau public est désactivé par défaut pour les nouvelles instances. Pour accéder aux ressources de l'instance via le réseau public, activez l'accès public dans la section Network Management de l'instance.

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

use Aliyun\OTS\OTSClient as OTSClient;

// Replace yourInstanceName with the actual instance name.
$instanceName = "yourInstanceName";
// Replace yourEndpoint with the actual instance endpoint.
$endpoint = "yourEndpoint";
// Read the AccessKey ID and AccessKey secret from environment variables.
$accessKeyId = getenv('TABLESTORE_ACCESS_KEY_ID');
$accessKeySecret = getenv('TABLESTORE_ACCESS_KEY_SECRET');

// Initialize the Tablestore client.
$client = new OTSClient(array(
    'EndPoint' => $endpoint,
    'AccessKeyID' => $accessKeyId,
    'AccessKeySecret' => $accessKeySecret,
    'InstanceName' => $instanceName,
));

// List all tables in the instance and print the result to the console.
$response = $client->listTable (array ());
print json_encode ($response);

Compatibilité des versions

La dernière version est la 5.x.x. Compatibilité :

Compatible avec le kit SDK 4.x.x.
Non compatible avec le kit SDK 2.x.x.

Pour l'historique des versions du kit SDK, consultez Versions historiques du kit SDK PHP.

FAQ

Références

Pour plus d'informations sur la gestion des erreurs dans Tablestore, consultez Gestion des erreurs du kit SDK PHP.