sangkilsoft / sangkilbiz-3
为SangkilBiz项目设计的Yii 2
Requires
- php: >=5.4.0
- yiisoft/yii2: *
- yiisoft/yii2-bootstrap: *
- yiisoft/yii2-debug: *
- yiisoft/yii2-gii: *
- yiisoft/yii2-swiftmailer: *
This package is not auto-updated.
Last update: 2024-09-28 14:32:50 UTC
README
Yii 2高级应用程序模板是一个最佳的骨架Yii 2应用程序,适用于开发具有多个层的高级Web应用程序。
该模板包括三个层级:前端、后端和命令行界面,每个都是一个独立的Yii应用程序。
该模板旨在在团队开发环境中工作。它支持在不同环境中部署应用程序。
目录结构
common
config/ contains shared configurations
mail/ contains view files for e-mails
models/ contains model classes used in both backend and frontend
tests/ contains various tests for objects that are common among applications
console
config/ contains console configurations
controllers/ contains console controllers (commands)
migrations/ contains database migrations
models/ contains console-specific model classes
runtime/ contains files generated during runtime
tests/ contains various tests for the console application
backend
assets/ contains application assets such as JavaScript and CSS
config/ contains backend configurations
controllers/ contains Web controller classes
models/ contains backend-specific model classes
runtime/ contains files generated during runtime
tests/ contains various tests for the backend application
views/ contains view files for the Web application
web/ contains the entry script and Web resources
frontend
assets/ contains application assets such as JavaScript and CSS
config/ contains frontend configurations
controllers/ contains Web controller classes
models/ contains frontend-specific model classes
runtime/ contains files generated during runtime
tests/ contains various tests for the frontend application
views/ contains view files for the Web application
web/ contains the entry script and Web resources
vendor/ contains dependent 3rd-party packages
environments/ contains environment-based overrides
需求
本应用程序模板对您的Web服务器的最低要求是支持PHP 5.4.0。
安装
从存档文件安装
将从yiiframework.com下载的存档文件解压到Web根目录下名为advanced
的目录中。
然后按照“入门”部分中的说明进行操作。
通过Composer安装
如果您没有Composer,您可以通过在getcomposer.org上查看说明来安装它。
然后,您可以使用以下命令安装应用程序:
php composer.phar create-project --prefer-dist --stability=dev sangkilsoft/sangkilbiz-3 sangkilbiz-3
入门
安装应用程序后,您必须执行以下步骤来初始化安装的应用程序。您只需要做一次。
- 运行命令
init
以使用特定环境初始化应用程序。 - 创建一个新的数据库,并相应地调整
common/config/main-local.php
中的components['db']
配置。 - 使用控制台命令
yii migrate
应用迁移。这将创建应用程序运行所需的所有表。 - 设置您的Web服务器的文档根目录
- 对于前端
/path/to/yii-application/frontend/web/
,使用URLhttp://frontend/
- 对于后端
/path/to/yii-application/backend/web/
,使用URLhttp://backend/
要登录到应用程序,您需要先注册,可以使用任何电子邮件地址、用户名和密码。然后,您可以使用相同的电子邮件地址和密码随时登录到应用程序。
测试
安装额外的composer包
php composer.phar require --dev "codeception/codeception: 1.8.*@dev" "codeception/specify: *" "codeception/verify: *"
此应用程序模板在测试中使用数据库,因此您应该创建三个在测试中使用的数据库
yii2_advanced_unit
- 单元测试数据库;yii2_advanced_functional
- 功能测试数据库;yii2_advanced_acceptance
- 接受测试数据库。
要使您的数据库保持最新,您可以在所需的测试文件夹中运行yii migrate
,例如,如果您从frontend
测试开始,则应在每个套件文件夹acceptance
、functional
、unit
中运行yii migrate
,这将根据迁移将您的数据库升级到最后状态。
要运行验收测试,您需要一个正在运行的Web服务器。为此,您可以使用PHP内置的服务器,并在主项目文件夹所在的目录下运行它。例如,如果您的应用程序位于/www/advanced
,您只需要执行以下操作:cd /www
,然后php -S 127.0.0.1:8080
,因为验收测试的默认配置期望应用程序的URL为/advanced/
。如果您已经配置了服务器或您的应用程序不在名为advanced
的文件夹中,您可能需要调整frontend/tests/_bootstrap.php
和backend/tests/_bootstrap.php
中的TEST_ENTRY_URL
。
完成上述操作后,您应该能够运行测试,例如,要运行frontend
测试,请执行以下操作:
cd frontend
../vendor/bin/codecept build
../vendor/bin/codecept run
以类似的方式,您可以运行其他应用程序层(如backend
、console
、common
)的测试。
您还可以调整应用程序套件配置和_bootstrap.php
设置,以使用其他URL和文件,就像在yii2-basic
中那样。