rad/rad-framework

快速应用程序开发框架。

v1.0.3 2023-05-28 10:35 UTC

This package is auto-updated.

Last update: 2024-09-25 13:00:32 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License PHP Version Require Maintainability

RAD 框架

RAD(快速应用程序开发)框架是一个轻量级且用户友好的PHP框架,专为快速高效地开发Web应用程序而设计。创建此框架的主要动机是为重视速度和效率的开发者提供一个简单易用的工具。

RAD框架的目标是提供一个坚实的基础,用于构建Web应用程序,同时将学习曲线降至最低。它旨在提供在Web开发过程中通常需要的核心功能和功能,而不添加不必要的复杂性。通过关注简单性和灵活性,RAD框架使开发者能够专注于其特定的应用程序逻辑,而不是陷入复杂的框架细节。

鼓励开发者使用RAD框架来显著加速他们的应用程序开发过程。无论您是在构建一个小型项目还是一个更庞大的Web应用程序,RAD框架的模块化结构和遵循PHP标准(如PSR-3、PSR-4、PSR-7等)确保了平稳和可维护的开发。

此框架是开源的,这意味着您可以根据您特定的项目需求自由使用、修改和扩展它。社区反馈和贡献非常宝贵,因为它们有助于改进框架并使其适应各种用例。使用RAD框架,开发者有一个可靠且轻量级的解决方案,可以加速他们的Web应用程序开发,而不会牺牲性能或灵活性。

PSR标准

RAD框架是一个旨在简化Web开发流程的PHP框架。

它遵循各种PHP标准建议(PSRs),以确保代码的互操作性和可维护性。

以下是RAD框架遵循的PSRs概述

  • PSR-3 Logger Interface: 框架使用PSR-3进行日志记录,提供了一种标准化的日志消息记录方法。
  • PSR-4 Autoloader: 使用PSR-4自动加载标准,允许基于命名空间进行有效的类自动加载。
  • PSR-7 Http Message: RAD利用PSR-7标准,由Guzzle HTTP提供支持,用于处理HTTP消息,提供了一种一致的方式与HTTP请求和响应交互。
  • PSR-11 Container: 框架使用PSR-11进行依赖注入,通过容器实现依赖项的管理和检索。
  • PSR-14 EventDispatcher: RAD使用PSR-14进行事件分发,促进了组件的解耦并推动了观察者模式。
  • PSR-15 Middleware (Work in Progress): 框架正在实施PSR-15,它定义了处理HTTP请求和响应的中间件接口。
  • PSR-16 Caching: RAD遵循PSR-16进行缓存,允许开发者有效地实现缓存机制。
  • PSR-17 Http Factory: 框架采用PSR-17,由Guzzle HTTP提供支持,以标准化的方式创建HTTP请求和响应对象。

遵循这些PSR标准,RAD框架确保代码一致性,提高代码重用性,并在PHP开发社区内促进协作。

凭借其对性能的关注、优化的对象实例化、简化的依赖注入,RAD框架为开发者提供了一个强大且高效的开发环境,用于构建高性能Web应用程序。

安装

要使用RAD框架,您需要在您的系统上安装PHP 8.1或更高版本以及Composer。

Make sure you have PHP 8.1 or a later version installed. You can check your PHP version by running the following command in your terminal:
php -v

如果PHP尚未安装或您安装的是旧版本,您可以从官方PHP网站下载并安装最新版本:php.net。

如果您还没有安装Composer,请先安装它。Composer是PHP的依赖管理工具。您可以通过访问Composer网站上的说明来下载并安装它:getcomposer.org。

一旦配置好PHP和Composer,您可以通过将其包含在composer.json文件的require块中,将RAD框架添加到您的项目中。对于稳定版本,请添加以下行

"require": {
    "rad/rad-framework": "^1.0"
}

对于最新开发版本,您可以使用以下行

"require": {
    "rad/rad-framework": "dev-master"
}

添加行后,运行以下命令以安装RAD框架及其依赖项

composer install

Composer将根据您在composer.json文件中指定的版本获取适当的RAD框架版本,并在您的项目中设置必要的文件。

成功安装RAD框架后,您现在可以轻松快速地开始使用其流线化功能和灵活架构构建Web应用程序。

待办事项

  • 改进文档

使用方法

初始化新的Rad对象

<?php

require(__DIR__ . "/../vendor/autoload.php");

$app = new \Rad\Rad(__DIR__ . "/config/");

...

创建新的控制器

<?php

class Exemple extends \Rad\Controller\Controller {
    
    /**
     * @get /
     * @produce html
     */
    public function html(ServerRequestInterface $request, ResponseInterface $response, array $args): ResponseInterface {
        $response->getBody()->write("<b>Hello World</b>");
        return $response;
    }

}

将控制器添加到Rad API中

$app->addControllers([
    Example:class
]);

运行Rad API

$app->run();

您可以将闭包添加到run方法中

$app->run(function(){
	echo "End";
});

它是如何工作的

  • 配置

  • 中间件

  • 路由

  • 控制器

PSR支持

  • psr-3 日志接口
  • psr-4 自动加载器
  • psr-7 HTTP消息(感谢Guzzle Http)
  • psr-11 容器
  • psr-14 事件调度器(WIP 替代观察者模式)
  • psr-15 中间件(WIP)
  • psr-16 缓存
  • psr-17 HTTP工厂(感谢Guzzle Http)