terablaze / terablaze
一个快速且功能丰富的PHP MVC框架
Requires
- php: ^7.2
- symfony/dotenv: ^5.1@dev
- terablaze/core: dev-master
Requires (Dev)
- filp/whoops: ^2.9
- middlewares/debugbar: 9999999-dev
- middlewares/response-time: 9999999-dev
- symfony/var-dumper: ^5.1@dev
This package is auto-updated.
Last update: 2024-09-22 22:51:53 UTC
README
Terablaze是一个用于开发Web应用的PHP MVC框架。它是一个开源框架,遵循MIT许可证发布。
安装、配置和运行
需求
- Web服务器
- PHP
- MySQL (可选)
- 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
和$language
在src/App/views/home.php
视图文件中可用
要从另一个视图中加载视图,使用$this->includeView('App::included_view_file')
,这允许包含的视图访问父视图中提取的变量
稳定性状态
需要注意的是,这个框架目前非常不稳定,可能经常发生变化。尽管我们在多个实时项目中使用它(从非常简单的项目到非常大和复杂的项目),我们不建议您在生产环境中使用,除非您确信自己在做什么,并且愿意投入时间。
贡献
简单地克隆项目并创建拉取请求。尽量按照我们的代码风格走,不要偏差太大。
如果您有兴趣加入开发团队,请直接发送邮件至 tomiwa@teraboxx.com
请注意,这里使用的邮箱地址可能会很快更改。