Librería PHP para cURL

Tiempo estimado de lectura: 2 min

En Ticksy hemos escrito esta librería para hacer de forma rápida y sencilla las acciones más comunes (lectura, escritura, modificación y borrado de datos).


Instanciamos la librería:

To top

Creamos una instancia de la librería de Ticksy con la que posteriormente haremos las solicitudes.

Tan solo tendremos que pasarle como parámetro el token generado por nuestro cliente.

include_once 'ticksy_firebase_rest.php';

$clientToken = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcGlrZXkiOiJBSXph...";

$ticksy = new TicksyFirebaseRest($clientToken);

 

Leer datos

To top

Para leer un nodo de datos tendremos que pasarle la ruta de ese nodo al método GET (debe ser una ruta a la que tengamos permisos de lectura)

$path = "https://ticksy-es.firebaseio.com/path/to/my/data";
$result = $ticksy->GET($path);

if($result){
	print_r($result);
}else{
	echo('No results');
}

Se pueden hacer búsquedas más complejas utilizando filtros, con los parámetros limitToFirst, limitToLast, startAt, endAt e equalTo.

En este ejemplo solicitamos los datos ordenados por el número de factura (invoice_num) desde la 30 hasta la 50.

$path = "https://ticksy-es.firebaseio.com/path/to/my/data";
$filters = 'orderBy="invoice_num"&startAt=30&endAt=50';

$result = $ticksy->GET($path, $filters);

if($result){
	print_r($result);
}else{
	echo('No results');
}

 

Insertar datos

To top

Para insertar un nuevo dato en una ruta de la base de datos, utilizaremos el método POST, pasando como parámetro la ruta donde queremos que se inserte el nuevo registro y un objeto te tipo string que represente el nuevo dato.

El nuevo dato tiene que ser un json en formato string, de lo contrario el método devolverá un error (false).

El nuevo valor se insertará

$path = "https://ticksy-es.firebaseio.com/path/to/my/new/data";
$result = $ticksy->POST($path, '{"name":"John", "age":39}');

if($result){
	print_r($result);
}else{
	echo('No results');
}

El método POST devuelve un objeto con el ID del nuevo dato, o false si algo ha fallado.

(
    [name] => -L3ZWqrOeI4Phwo3dwft
)

 

Modificar datos

To top

Para modificar un dato existente le pasaremos al método PATCH la ruta de nuestro dato y un objeto de tipo string que represente el nuevo valor.

$path = "https://ticksy-es.firebaseio.com/path/to/my/data";
$result = $ticksy->PATCH($path, '{"name": "Peter"}');

if($result){
	print_r($result);
}else{
	echo('No results');
}

El método PATCH devuelve un objeto con los valores que se han modificado:

(
    [name] => Peter
)

 

Borrar datos

To top

Para eliminar un dato tan solo tenemos que pasarle la ruta que queremos borrar al método DELETE:

$path = "https://ticksy-es.firebaseio.com/path/to/delete";
$ticksy->DELETE($path);

 

Recuperar los datos codificados en el token de Ticksy

To top

Con el método getTicksyData() podemos ver los datos que viajan en el token proporcionado por nuestro cliente.

print_r($ticksy->getTicksyData());

(
    [apikey] => AIzaSyAotSXdV33y2YeJM5eeX78y875mK6jhkiu
    [email] => example@soporte.ticksy.app
    [password] => 123456789
    [manager] => gQVx9HApdhOJxfi7n5zLL1M8Eft2
    [localtype] => -KdMRch4lOLtbN1X-je5
    [local] => -KdM5zI3dIKa4rVoflrd4
)

 

Recuperar los datos del usuario logado

To top

Con el método getUserData() podemos ver los datos que ha devuelvo el login con la base de datos de Firebase:

print_r($ticksy->getUserData());

(
    [kind] => identitytoolkit#VerifyPasswordResponse
    [localId] => B61vPZqiEASxoeyIOO2eFhXgHjy6
    [email] => example@soporte.ticksy.app
    [displayName] => 
    [idToken] => eyJhbGciOiJSUzI1NiIsImtpZCI6ImRkMTQ2YWZiMmVlNDli...
    [registered] => 1
    [refreshToken] => AEoYo8vW_X_JCUiDYc7Cuq8wCvTbYpQbqgiyZ0Y_scqP3l...
    [expiresIn] => 3600
)

 

Siguiente >> Perfiles de acceso a la base de datos

¿te ha gustado este artículo?
0