shinesolar / shine-php
一个封装了基本 PDO 功能并与行业类似功能相匹配的 PHP 库。
Requires (Dev)
- phpunit/phpunit: ^9
README
这是一个非常简单的 PHP 库,允许开发者 SHINE!
这个版本是 Adam McGurk 在 Shine Solar, LLC 任职期间创建的版本的分支。
在以下位置找到 Adam 的新版本:https://github.com/Mcgurk-Adam/ShinePHP
类功能
- 默认情况下安全 CRUD(创建、读取、更新、删除)数据库交互
- 用于清理表或列名的方法(目前仅限 MySQL/MariaDB,即将支持更多 RDBMS),PDO 不具备此功能
- 能够轻松清理和验证电话号码、电子邮件地址、IP 地址、URL、字符串、浮点数、整数和布尔值
- 默认情况下安全 HTTP 方法,以及几种其他 HTTP 请求验证方法
- 强类型方法
- 自动防止 SQL 注入
- 命名空间,以防止名称冲突
- 等等!
你可能需要它的原因
Shine PHP 是为有一般 PHP 需求的开发者准备的。如果你需要向用户基础提供 CRUD(创建、读取、更新和删除)功能,并且不担心潜在的 SQL 注入漏洞,我们的 Crud() 类非常适合这个,它使用本机 PHP PDO 扩展。
如果你需要一个简单、默认情况下安全的方式验证和清理数据,我们有八个特定的静态类方法来执行此操作(包括处理电子邮件地址、URL、IP 地址和美国电话号码等方法),并且我们正在持续添加更多。
如果你需要一个安全的方式请求 HTTP 端点,我们的 EasyHttp 类使用默认情况下安全的本机 PHP cURL 函数(同时为你提供验证用户是否是你想要访问你的 URL 的用户的方法)。
Shine PHP 不是什么
Shine PHP 不是一个功能丰富的框架,它不是为了这个而设计的,我们也没有立即将其转变为框架的打算。它是一个旨在使数据库事务、数据处理和 HTTP 请求变得简单的库。
Shine PHP 从不打算与低于 PHP 7 的任何版本向后兼容。这个框架的整个想法是强制执行安全和安全的 PHP 编程。
最后,Shine PHP 不适合有特定需求的开发者。如果你只是启动了一个小型博客或简单的 Web 应用程序,Shine PHP 可能正是你需要和想要的。然而,如果你有特定的数据库需求,Shine PHP 可能不适合你。或者,如果你不在美国,HandleData 中的方法不适用于非美国电话号码。
基本上,除非你是世界上 5% 的 PHP 开发者,否则 Shine PHP 至少会在某个地方满足你的需求。
要求
- PHP 7.0.0 的最低 PHP 版本
- PHP 的 cURL 驱动程序
- PHP 的 PCRE 驱动程序
安装和执行
ShinePHP 可在 Packagist 上找到(使用语义版本控制),通过 Composer 安装是推荐的方式安装 ShinePHP。只需将此行添加到你的 composer.json 文件中
"shinesolar/shine-php": "^1.0.0"
或运行
composer require shinesolar/shine-php
以下是包含库的方法
<?php declare(strict_types=1); require_once 'path/to/vendor/autoload.php'; use ShinePHP\{Crud, CrudException, HandleData, EasyHttp}; // Put the rest of your code here
类和方法文档
Crud
Crud 是一个相当简单的类,允许您与数据库交互。它对可以与之交互的 RDMBS 没有任何限制(但是,它的表/列清理有一些限制),并且您可以通过环境变量(最安全)或配置文件声明凭证。