terablaze/terablaze

一个快速且功能丰富的PHP MVC框架

dev-master 2023-01-22 19:18 UTC

This package is auto-updated.

Last update: 2024-09-22 22:51:53 UTC


README

Terablaze是一个用于开发Web应用的PHP MVC框架。它是一个开源框架,遵循MIT许可证发布。

安装、配置和运行

需求

  1. Web服务器
  2. PHP
  3. MySQL (可选)
  4. Composer

安装。

1. 通过Composer (推荐)

导航到服务器上希望访问的文件夹,并在命令行中运行以下命令。

composer create-project terablaze/terablaze ./

在当前文件夹中安装

composer create-project terablaze/terablaze project-folder

在'project-folder'中安装

配置

首先,使用.ent.template文件作为指导来创建一个.env文件

尽管默认的Terablaze配置设置足以开始使用,但建议并且在某些情况下是强制性的,需要通过config目录进行相应的配置。

运行

通过命令行导航到项目的根文件夹,并运行

php -S localhost:8000

在浏览器中访问https://:8000

如果您没有使用内置的PHP服务器,可以通过您的服务器在浏览器中访问您的安装文件夹(可能是实时域名、远程IP或本地主机,如果您在本地机器上运行)。

如果您没有错误地看到了Terablaze欢迎页面,那么您的安装是成功的。

欢迎页面的控制器是src/App/Controller/WelcomeController.php,视图文件是src/App/views/welcome.php

使用

控制器

src/App/Controller文件夹中创建您的控制器(您可以使用任何目录,只要控制器命名空间/类与目录/文件路径匹配即可)。

您的控制器类应该扩展基本控制器\Terablaze\Controller\Controller以访问基本控制器提供的某些功能

模型

src/App/Model文件夹中创建您的模型(您可以使用任何目录,只要模型命名空间/类与目录/文件路径匹配即可)。

您的模型类应该扩展基本模型\Terablaze\Ripana\ORM\Model

视图

src/App/views文件夹中创建您的视图。

要加载视图文件,只需使用

$viewContent = $this->renderView('App::view_file_with_or_without_extension')return $this->render('App::view_file_with_or_without_extension'); 以返回一个包含加载视图内容的响应实例

传递一个可选的第二个参数,它是一个数组,并在内部提取,因此在视图中作为变量可用。

例如

$data = [
    'name' = 'Terablaze',
    'type' = 'MVC Framework',
    'language' = 'PHP'
];

$this->renderView('App::home', $data);

上面的代码将使变量$name$type$languagesrc/App/views/home.php视图文件中可用

要从另一个视图中加载视图,使用$this->includeView('App::included_view_file'),这允许包含的视图访问父视图中提取的变量

稳定性状态

需要注意的是,这个框架目前非常不稳定,可能经常发生变化。尽管我们在多个实时项目中使用它(从非常简单的项目到非常大和复杂的项目),我们不建议您在生产环境中使用,除非您确信自己在做什么,并且愿意投入时间。

贡献

简单地克隆项目并创建拉取请求。尽量按照我们的代码风格走,不要偏差太大。

如果您有兴趣加入开发团队,请直接发送邮件至 tomiwa@teraboxx.com

请注意,这里使用的邮箱地址可能会很快更改。