PHP SDK - Tablestore - Tablestore - Centro de documentación de Alibaba Cloud

Use el SDK de Tablestore para PHP para ejecutar operaciones del modelo wide column.

Inicio rápido

Prepare su entorno, instale el SDK e inicialice un cliente.

Preparar el entorno

PHP de 64 bits en la versión 5.5 o posterior. Ejecute php -v para comprobar su versión.

Nota
Tablestore utiliza enteros de 64 bits. PHP de 32 bits solo puede representarlos como valores string, por lo que no es compatible. En Windows, las versiones de PHP anteriores a la 7 carecen de soporte real para enteros de 64 bits. Use PHP 7 o posterior.
Si usa HTTPS, instale la extensión OpenSSL de PHP.
Un IDE de PHP, como Eclipse for PHP.
La extensión cURL (recomendada). Ejecute php -m para comprobar la instalación.

Instalar el SDK

Instale el SDK con Composer o desde un paquete de código fuente.

Composer

Para instalarlo con Composer:

Ejecute composer require aliyun/aliyun-tablestore-sdk-php en la raíz del proyecto, o agregue la dependencia al archivo composer.json.
```
{
    "require": {
        "aliyun/aliyun-tablestore-sdk-php": "^5.1"
    }
}
```
Ejecute composer install. La estructura de directorios resultante es la siguiente:
```
 .
 ├── app.php
 ├── composer.json
 ├── composer.lock
 └── vendor
```
El directorio vendor/ contiene las bibliotecas instaladas. Incluya el cargador automático en su aplicación:
```
require_once __DIR__ . '/vendor/autoload.php';
```
Nota
Omita este paso si su proyecto ya incluye el archivo autoload.php.

Paquete de código fuente

Descargue el paquete de código fuente:

Vaya a GitHub y descargue la versión que necesite.
Descargue el paquete de código fuente del SDK.

El SDK incluye programas de ejemplo para las operaciones más comunes del modelo wide column:

Descargue y extraiga el paquete del SDK. Los ejemplos se encuentran en el directorio examples.
Explore el repositorio de GitHub aliyun-tablestore-php-sdk.

Configurar las credenciales de acceso

Create an AccessKey para su cuenta de Alibaba Cloud o usuario de RAM y, después, configúrela como variable de entorno para evitar codificar las credenciales directamente en el código.

Reinicie su IDE, terminal, otras aplicaciones de escritorio y servicios en segundo plano después de la configuración para cargar las variables de entorno actualizadas. Para obtener más información sobre otros tipos de credenciales de acceso, consulte Configure access credentials .

Linux

Agregue las variables de entorno al final del archivo ~/.bashrc:

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

Aplique los cambios:
```
source ~/.bashrc
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

Compruebe cuál es su shell predeterminado:
```
echo $SHELL
```

Configure las variables según el tipo de shell que utilice:

Zsh

Agregue las variables de entorno al final del archivo ~/.zshrc:

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

Aplique los cambios:
```
source ~/.zshrc
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Bash

Agregue las variables de entorno al final del archivo ~/.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

Aplique los cambios:
```
source ~/.bash_profile
```

Compruebe las variables de entorno:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD

Establezca las variables de entorno en CMD:

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Reinicie CMD y compruebe los valores:

echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%

PowerShell

Ejecute los siguientes comandos en 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)

Compruebe las variables de entorno:

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

Inicializar un cliente

Inicialice un cliente de Tablestore y liste las tablas para comprobar la conexión.

Importante

El acceso por red pública está deshabilitado de forma predeterminada en las nuevas instancias. Para acceder a los recursos de la instancia mediante la red pública, habilite el acceso público en Network Management de la instancia.

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);

Compatibilidad de versiones

La versión más reciente es la 5.x.x. Su compatibilidad es la siguiente:

Es compatible con el SDK 4.x.x.
No es compatible con el SDK 2.x.x.

Para consultar el historial de versiones del SDK, vea PHP SDK historical versions.

Preguntas frecuentes

Referencias

Para obtener información sobre el manejo de errores en Tablestore, consulte PHP SDK error handling.