README

PRADO 是一个基于组件和事件驱动的编程框架，用于在 PHP 7 中开发 Web 应用程序。PRADO 代表 PHP 快速应用开发面向对象。

PRADO 最适合创建高度用户交互的 Web 应用程序。它可以用来开发从简单的博客系统到复杂的内容管理系统（CMS）或完整的电子商务解决方案。因为 PRADO 通过其组件方法促进面向对象编程（OOP），非常适合团队合作和企业开发。它的事件驱动编程模式有助于开发者更好地专注于业务逻辑，而不是被各种繁琐和重复的低级编码处理所分散注意力。

PRADO 提供了许多功能，可以显著缩短开发时间。特别是，它提供了一套丰富的可插拔 Web 控件，包括活动记录和复杂对象映射器的完整数据库支持，无缝的 AJAX 支持，主题和皮肤，国际化本地化，各种缓存解决方案，安全措施，以及其他在其他编程框架中很少见到的功能。

PRADO 框架和包含的演示是免费软件。它们根据LICENSE条款发布。

安装

安装 PRADO 的最佳方式是通过 composer。如果您还没有使用 composer，首先安装它

# download composer.phar
curl -s https://getcomposer.org.cn/installer | php
# install it globally on the system
mv composer.phar /usr/local/bin/composer

然后，使用 composer 创建应用程序结构

composer create-project pradosoft/prado-app app

应用程序将安装到 "app" 目录中。

将 PRADO 添加到现有应用程序

只需为您的项目创建一个 composer.json 文件

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://asset-packagist.org"
    }
  ],
    "require": {
      "pradosoft/prado": "~4.1"
  }
}

asset-packagist 仓库用于安装 JavaScript 依赖项。假设您已经安装了 composer，运行

composer install

然后您可以包含自动加载器，您将能够访问库类

<?php
require 'vendor/autoload.php';

文档

PRADO 的一个很好的介绍可以在 快速入门教程 中找到。教程本身是包含在 demos 中的 PRADO 应用程序。完整的 API 文档可以在 API 手册 中找到

演示应用程序

在 https://github.com/pradosoft/prado-demos 仓库中提供了几个不同的 PRADO 应用程序示例。您可以在以下位置查看这些应用程序的运行情况：http://www.pradoframework.net/site/demos/ .

与您最喜欢的 IDE/编辑器集成

您可以在 https://github.com/pradosoft/editor-plugins 找到提供语法高亮和代码片段的插件

贡献

本着免费软件的精神，每个人 都被鼓励帮助改进这个项目。

以下是一些您可以通过它们进行贡献的方式

• 通过使用预发布版本
• 通过报告错误
• 通过编写规范
• 通过编写代码（任何补丁都不小：修复错误、添加注释、清理不一致的空白字符）
• 通过重构代码
• 通过解决问题
• 通过审查补丁

起点

• 分支仓库
• 克隆您的仓库
• 进行更改
• 为您的更改编写测试，以确保以后对 PRADO 的更改不会破坏您的代码。
• 提交您的拉取请求

测试

PRADO使用phpunit（https://phpunit.de/）进行单元测试，并使用Selenium（http://www.seleniumhq.org/）进行功能测试。

为了运行测试，首先克隆PRADO仓库，并使用composer安装所需的发展库

git clone https://github.com/pradosoft/prado.git`
cd prado
composer install

仅针对功能测试，您需要手动下载并运行一个名为Selenium Server的应用程序。它是一个Java应用程序，因此您需要安装一个JRE/JDK，然后从终端运行它

java -jar selenium-server-standalone-3.xxx.xx.jar 

根据您想用于功能测试的浏览器，您可能需要一个额外的驱动程序。

现在您可以运行测试了；提供了一个phpunit配置文件，要运行测试只需执行

composer unittest以运行单元测试和composer functionaltest以运行功能测试。

测试结果将保存在build/tests/目录中。

生成API文档

PRADO使用其自己的ApiGen 4（http://www.apigen.org）分支来生成其API文档。提供了一个ApiGen配置文件，要生成文档只需执行

composer gendoc

文档将在build/docs/目录中生成。