PHP sdk - Tablestore - Tablestore: Central de Documentação do Alibaba Cloud

Início rápido

Prepare o ambiente, instale o SDK e inicialize um cliente.

Prepare o ambiente

PHP 5.5 de 64 bits ou superior. Execute php -v e verifique a versão.

Nota
O Tablestore usa inteiros de 64 bits. O PHP de 32 bits só pode representá-los como valores string e não é compatível. No Windows, as versões do PHP anteriores à versão 7 não oferecem suporte nativo para inteiros de 64 bits. Use o PHP 7 ou superior.
Se usar HTTPS, instale a extensão OpenSSL do PHP.
Uma IDE PHP, como o Eclipse for PHP.
A extensão cURL (recomendada). Execute php -m e verifique a instalação.

Instale o SDK

Instale o SDK com o Composer ou a partir de um pacote de código-fonte.

Composer

Instale com o Composer:

Execute composer require aliyun/aliyun-tablestore-sdk-php na raiz do projeto, ou adicione a dependência ao arquivo composer.json.
```
{
    "require": {
        "aliyun/aliyun-tablestore-sdk-php": "^5.1"
    }
}
```
Execute composer install. Estrutura de diretórios resultante:
```
 .
 ├── app.php
 ├── composer.json
 ├── composer.lock
 └── vendor
```
O diretório vendor/ contém as bibliotecas instaladas. Inclua o autoloader na sua aplicação:
```
require_once __DIR__ . '/vendor/autoload.php';
```
Nota
Ignore esta etapa se o seu projeto já incluir o arquivo autoload.php.

Pacote de código-fonte

Baixe o pacote de código-fonte:

Acesse o GitHub e baixe a versão desejada.
Baixe o pacote de código-fonte do SDK.

O SDK inclui programas de exemplo para operações comuns do modelo de coluna larga:

Baixe e extraia o pacote do SDK. Os exemplos estão no diretório examples.
Acesse o repositório do aliyun-tablestore-php-sdk no GitHub.

Configure as credenciais de acesso

Crie um AccessKey para a sua conta Alibaba Cloud ou usuário RAM e configure-o como uma variável de ambiente para evitar a codificação rígida de credenciais.

Reinicie a IDE, o terminal, outros aplicativos de desktop e os serviços em segundo plano após a configuração para carregar as variáveis de ambiente atualizadas. Para obter mais informações sobre outros tipos de credenciais de acesso, consulte Configure access credentials .

Linux

Adicione as variáveis de ambiente ao arquivo ~/.bashrc:

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

Aplique as alterações:
```
source ~/.bashrc
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

macOS

Verifique o seu shell padrão:
```
echo $SHELL
```

Configure de acordo com o tipo do seu shell:

Zsh

Adicione as variáveis de ambiente ao arquivo ~/.zshrc:

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

Aplique as alterações:
```
source ~/.zshrc
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Bash

Adicione as variáveis de ambiente ao arquivo ~/.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 as alterações:
```
source ~/.bash_profile
```

Verifique as variáveis de ambiente:

echo $TABLESTORE_ACCESS_KEY_ID
echo $TABLESTORE_ACCESS_KEY_SECRET

Windows

CMD

Defina as variáveis de ambiente no CMD:

setx TABLESTORE_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx TABLESTORE_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

Reinicie o CMD e verifique as variáveis:

echo %TABLESTORE_ACCESS_KEY_ID%
echo %TABLESTORE_ACCESS_KEY_SECRET%

PowerShell

Execute no 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)

Verifique as variáveis de ambiente:

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

Inicialize um cliente

Inicialize um cliente do Tablestore e liste as tabelas e verifique a conexão.

Importante

O acesso à rede pública é desabilitado por padrão para novas instâncias. Para acessar os recursos da instância pela rede pública, ative o acesso público no Network Management da instância.

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

Compatibilidade de versões

A versão mais recente é a 5.x.x. Compatibilidade:

Compatível com o SDK 4.x.x.
Incompatível com o SDK 2.x.x.

Para acessar o histórico de versões do SDK, consulte PHP SDK historical versions.

Perguntas frequentes

Referências

Para obter informações sobre o tratamento de erros no Tablestore, consulte PHP SDK error handling.