Exemplos

O ponto de entrada central para a X DevAPI é a função mysql_xdevapi\getSession(), que recebe uma URI para um servidor MySQL 8.0 e retorna um objeto mysql_xdevapi\Session.

Exemplo #1 Conectando a um Servidor MySQL

<?php
try {
    $session = mysql_xdevapi\getSession("mysqlx://usuario:senha@servidor");
} catch(Exception $e) {
    die("Não foi possível estabelecer conexão: " . $e->getMessage());
}

// ... use $session
?>

A sessão fornece acesso completo à API. Para uma nova instalação do Servidor MySQL, o primeiro passo é criar um esquema com uma coleção para armazenar dados:

Exemplo #2 Criando um Esquema e uma Coleção no Servidor MySQL

<?php
$schema = $session->createSchema("teste");
$collection = $schema->createCollection("exemplo");
?>

Ao armazenar dados, normalmente json_encode() é usada para codificar os dados em JSON, que assim podem ser armazenados em uma coleção.

O exemplo a seguir armazana dados na coleção criada anteriormente, e depois recupera partes dela novamente.

Exemplo #3 Armazenando e Recuperando Dados

<?php
$marco = [
  "nome" => "Marco",
  "idade"  => 19,
  "emprego"  => "Programador"
];
$mike = [
  "nome" => "Mike",
  "idade"  => 39,
  "emprego"  => "Gerente"
];

$schema = $session->getSchema("teste");
$collection = $schema->getCollection("exemplo");

$collection->add($marco, $mike)->execute();

var_dump($collection->find("nome = 'Mike'")->execute()->fetchOne());
?>

O exemplo acima produzirá algo semelhante a:

array(4) {
  ["_id"]=>
  string(28) "00005ad66aaf0000000000000003"
  ["idade"]=>
  int(39)
  ["emprego"]=>
  string(7) "Gerente"
  ["nome"]=>
  string(4) "Mike"
}

O exemplo demonstra que o Servidor MySQL adiciona um campo extra de nome _id, que serve como chave primária para o documento.

O exemplo também demonstra que os dados recuperados são ordenados alfabeticamente, Esta ordem específica vem do armazenamento binário eficiente dentro do servidor MySQL, mas isso nem sempre é confiável. Refira-se à documentação do tipo de dados JSON do MySQL para detalhes.

Opcionalmente, use os iteradores do PHP para buscar múltiplos documentos:

Exemplo #4 Buscando e Iterando sobre Múltiplos Documentos

<?php
$result = $collection->find()->execute();
foreach ($result as $doc) {
  echo "{$doc["nome"]} é um {$doc["emprego"]}.\n";
}
?>

O exemplo acima produzirá algo semelhante a:

Marco é um Programador.
Mike é um Gerente.