arx / project
Arx 启动项目模板
Requires
- php: >=5.5.9
- arx/arxmin: 5.2.2
- arx/core: 5.2.*
- laravel/framework: 5.2.*
Requires (Dev)
- fzaninotto/faker: ~1.4
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~4.0
- symfony/css-selector: 2.8.*|3.0.*
- symfony/dom-crawler: 2.8.*|3.0.*
README
这里包含什么?
Arx项目提供了一个干净的启动项目模板,以Laravel 5开始。它包括
- Laravel
- 默认使用Laravel包,如:ide-helper, debugbar等。
- Arx Core作为Laravel的扩展(更多信息请见https://github.com/cherrylabs/arx-core)
- Arx/core改进
- 模板引擎以处理angular模板(与blade相同,唯一的区别是{{}}被替换为<% %>以更好地适应angular,并且你可以通过一个助手 $this->help() 在视图中调用,以了解哪些变量可用)
- 自动body属性类属性基于Paul Irish结构
- 使用Kint进行更好的debug var_dump
- 资产管理
- ide-helper生成器
- laravel debug-bar
- gulp生成器
- angular生成器(控制器、指令、过滤器等)
- 额外的类,如Image类助手、Dummy文本生成器、Hook助手、Opengraph阅读器等。
- 启动布局与bootstrap结构
- Bootstrap助手
- 有用的API类和助手
- 有用的特性,可在模型中使用以处理文件上传等。
- Angular + Bootstrap3 +常用UI插件
- 带有PHP 5.4, benstalkd, mongo配置的Vagrant配置(如果需要的话)
- 处理资产的Gulp默认配置
- 默认bower配置,包含启动项目中常用的插件
要开始使用Arx项目,你可以使用Composer创建一个项目,如下所示
composer create arx/project your_app_name
如果你是Laravel的新手,我们强烈建议你阅读其精彩的文档,请访问https://laravel.net.cn/docs
要求
- PHP > 5.4
- Composer 遵循以下步骤
推荐
- Nodejs以处理你的资产包
- Bower以安装包
- Gulp
如何安装?
sudo php composer{link to you composer phar or global} create arx/project {Your folder destination} --prefer-source
# Example
php composer create arx/project myapp --prefer-source
权限
/!\ 在安装Laravel后,您可能需要授予Web服务器对app/storage目录的写入权限。有关配置的更多信息,请参阅安装文档。
如何运行?
使用Wamp|Mamp|Xampp等运行
如果您有Mamp\Wamp,您只需运行到localhost/{项目路径}。例如:localhost/myapp/public
在终端中使用您的PHP CLI运行
如果您没有,您可以在终端中运行(在项目根目录)
php artisan serve
然后您将通过: https://:8000 访问您的项目
- 此选项需要您安装mcrypt扩展查看
使用Vagrant运行(最佳方式)
您也可以使用Vagrant启动项目。
只需从这里下载Vagrant此处
然后在项目的根目录下的终端中运行
vagrant up
这就完成了,您可以通过https://:8080访问 :-)
如何安装资源
Arx项目使用Gulp和Bower来美化界面。您需要安装Node、Bower和Gulp。
然后在项目的根目录下
在终端中运行
bower install
npm install
理念
Laravel的Elixir非常棒,但除了在Laravel项目中使用外,在其他情况下不可用,并且它并不像直接使用Gulp插件那样灵活...
此外,我们决定将配置和流程逻辑分开,这样您就可以更容易地将配置资源复制粘贴到其他项目中,并对其进行不同的处理。
这就是为什么您有两个文件的原因
- gulp-config.js
- gulpfile.js
Gulp-config几乎有90%的地方您将处理资源。它处理了大多数资源案例,并提供了一种使用<%= %>或组织资源的最简单方式。
您可以阅读gulp-config以获取有关其工作方式的更多信息。
可选
Arx附带了一个可选的资产包,用于演示或快速应用程序原型设计。您可以使用以下方式发布资产
php artisan assets:publish arx/core
它将在public/packages/arx/core文件夹中创建一个文件夹。但是,如果您不需要它,您可以将其删除。
如何报告错误或建议?
如果您想报告错误或建议,请访问我们的集中式问题跟踪器我们的问题跟踪器
如何贡献?
如果您想为Arx项目做出贡献,请访问我们的Arx-contrib存储库