README

关于

QuidPHP/Assert 仓库包含一个用于运行测试套件的应用程序。此测试套件包含大约 15000 个断言，将彻底测试您的 PHP 设置。它还附带了一些 JavaScript 测试。

许可协议

QuidPHP/Assert 在 MIT 许可协议 下作为开源软件提供。

文档

QuidPHP/Assert 文档可在 QuidPHP/Docs 找到。

安装

QuidPHP/Assert 可以通过 Composer 简单安装。它在 Packagist 上可用。

$ composer create-project quidphp/assert --prefer-dist

要求

QuidPHP/Assert 需要以下条件

• Apache 或 Nginx 服务器（在 MacOs 或 Linux 环境中运行）。
  • 在 Windows 环境中也能工作，但存在一些 已知问题。
• PHP 8.1
  • 需要以下扩展
    • ctype
    • curl
    • date
    • fileinfo
    • gd
    • iconv
    • json
    • mbstring
    • pcre
    • openssl
    • session
    • SimpleXML
    • zip
    • PDO
    • pdo_mysql
  • 以及以下 PHP INI 指令
    • post_max_size 必须至少为 1MB
    • post_max_size 必须大于 upload_max_filesize
    • memory_limit 必须至少为 128MB
• Mysql (> = 8.0) 或 MariaDB (> = 10.4) 数据库
• 任何现代浏览器（非 Internet Explorer）

依赖项

QuidPHP/Assert 有以下依赖项

• quidphp/site - Quid\Site - 使用 QuidPHP 框架和 LemurCMS 构建网站的扩展平台

所有依赖项将通过 Composer 安装过程解决。

设置

安装完成后，只需按照以下步骤操作

1. 确保主目录和所有子目录都可通过您的 Web 服务器写入。
2. 配置 Apache 虚拟主机或 Nginx 服务器块，以便将域名指向 public 文件夹的文档根。
3. 在新的 Mysql/MariaDB 数据库中导入 db.sql。
4. 复制 env-default.php 文件，并将其重命名为 env.php。
5. 在 env.php 文件中更新方案主机以反映您的服务器配置。
6. 在 env.php 文件中更新数据库参数。

通过 HTTP 启动

在您的 Web 浏览器中输入 public/index.php 入口文件的 URL。

通过 CLI 启动

在命令行中打开项目文件夹。您现在可以按以下格式提交命令

php quid
php quid :prod/assert

概览

QuidPHP/Assert 包含 9 个文件。以下是一个概览

• .gitignore - 测试套件的标准 .gitignore 文件
• composer.json - 声明所有 Composer PHP 依赖项的文件
• db.sql - QuidPHP 测试套件所需的 SQL 数据库
• env-default.php - 声明测试套件的环境数据，复制此文件并重命名为 env.php
• LICENSE - 仓库的 MIT 许可文件
• quid - 通过 CLI 启动测试套件的文件
• README.md - 以 markdown 格式的本说明文件
• public/.htaccess - 简单的 Apache 指令文件，需要 mod_rewrite
• public/index.php - 通过 HTTP 请求启动测试套件的索引文件

已知问题

• 当使用命令提示符时，测试套件在 Windows 上失败。
• 在 Windows 上，创建符号链接存在一些问题。
• 在 Windows 上，您需要将 lower_case_table_names = 2 添加到您的数据库配置文件（my.cnf）中。表和列名需要以自然大小写存储。
• 在某些配置中，您可能需要将您的域名添加到系统 hosts 文件中。如果不这样做，一些涉及 curl 的断言可能会失败。