arx/project

此包已被弃用且不再维护。未建议替代包。

Arx 启动项目模板

5.2.0 2016-02-03 18:01 UTC

This package is auto-updated.

Last update: 2019-10-14 19:43:09 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version

这里包含什么?

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

要求

推荐

  • 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来美化界面。您需要安装NodeBowerGulp

然后在项目的根目录下

在终端中运行

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存储库