README

PHP 版本的简单 Repl.it 数据库客户端。基于 replit/database-node。

需求

• PHP >= 8.0;
• Composer.

安装

composer require fatfingers23/replit-database-client

开始使用

<?php

require_once 'vendor/autoload.php';

use Fatfingers23\ReplitDatabaseClient\DatabaseClient;

$client = new DatabaseClient();
$client->set('key', 'value');
$key = $client->get('key');
echo $key;

文档

客户端

class DatabaseClient(String url?)

可以传递自定义 URL

原生函数

set(string $key, array|string $value): void

设置具有字符串值的键

<?php
$client->set('key', 'value');

设置具有数组值的键

<?php
$client->set('key', ['greeting' => 'Hello World!']);

get(string $key): array|string|null

获取具有字符串值的键

<?php
$key = $client->get('key');
echo $key;

获取具有数组值的键

<?php
$key = $client->get('key');
var_dump($key);
echo $key['greeting'];

delete(string $key): void

通过键删除数据库中的条目

<?php
$client->delete('key');

getPrefixKeys(string $prefix): array

• 返回以前缀开始的键数组
• 如果没有给定前缀，则返回数据库中的所有键
• 如果没有找到键，则返回空数组

<?php
$client->set('poet.1', 'John Keats');
$client->set('poet.2', 'Emily Dickinson');
$poetKeys = $client->getPrefixKeys('poet');

#var_export($poetKeys) result below
array (
  0 => 'poet.1',
  1 => 'poet.2',
)

扩展函数

getPrefix(string $prefix): ?array

• 返回前缀的所有值数组
• 如果没有给定前缀，则返回整个数据库
• 如果没有找到前缀，则返回 null

<?php
$client->set('poet.1', 'John Keats');
$client->set('poet.2', 'Emily Dickinson');
$poets = $client->getPrefix('poet');

#var_export($poets) result below
array (
  'poet.1' => 'John Keats',
  'poet.2' => 'Emily Dickinson',
)

deleteByPrefix(string $prefix = '')

• 通过前缀删除一系列键
• 注意：如果没有给定前缀，此函数将删除整个数据库

<?php
$client->deleteByPrefix('poet');

测试

composer test

或者在 Repl.it 中打开并点击运行

贡献

1. 分支它。
2. 创建你的功能分支（git checkout -b my-new-feature）。
3. 进行更改。
4. 运行测试，如有必要，添加你自己的代码的测试用例（phpunit）。
5. 提交更改（git commit -am '添加一些功能'）。
6. 推送到分支（git push origin my-new-feature）。
7. 创建新的 pull request。