tavo1987 / mini-framework
用于落地页面的迷你框架
Requires
- php: >=5.6.4
- bryanjhv/slim-session: ^3.5
- illuminate/database: ~5.4.36
- robmorgan/phinx: ^0.9.2
- slim/csrf: ^0.8.2
- slim/flash: ^0.4.0
- slim/slim: ~3.0
- slim/twig-view: ~2.4
- swiftmailer/swiftmailer: ~5.0
- tavo1987/ec-validador-cedula-ruc: ^1.0
- vlucas/valitron: ^1.3
Requires (Dev)
- symfony/var-dumper: ~3.3
- vlucas/phpdotenv: ~2.4
- zeuxisoo/slim-whoops: ~0.6.3
This package is auto-updated.
Last update: 2024-08-26 23:37:14 UTC
README
Slim Starter Kit
这是一个使用 Slim 3.0 框架快速开发落地页或小型应用的快速启动工具包,其结构类似于 Laravel。
nota: Documentación en progreso
特点
- 验证
- 电子邮件
- Laravel mix
- 迁移
- 控制器
- 通过 Eloquent 使用实体或模型
- 使用 twig 模板引擎的视图
- 电子邮件模板
- 友好的 URL
- 通过 composer 容易安装
- 基本认证模块
- 中间件
- 支持 CSRF
- 会话
- 闪存消息
使用的技术和工具
- Slim 3
- Sass
- Laravel mix
- Vuejs
- VeeValidate
- Foundation 6.4.1
- Tailwincs
- Eloquent ORM
- Twig
- Dotenv
- Swift Maile
- Valitron
- Whoops
- Laravel Collections
- Web font loader
- Phinx
- Laravel 迁移
辅助工具
* dd()
* dump()
* collect()
* SendEmail()
* parseUrl()
要求
"php": ">=5.6.4"
安装和配置
- 执行以下命令创建项目
composer create-project tavo1987/mini-framework project-name
- 创建数据库以保存表单数据
- 在
.env
文件中配置正确的数据 - 执行以下命令创建默认的
users
、leads
和migrations
表vendor/bin/phinx migrate
- 通过变量
VALITRON_LANG
选择 Valitron 消息的语言,其值可以是en
或es
,默认为英语 - 好了!这就是全部了
编译资源文件
为了编译资源文件,我们选择了 Laravel mix,它通过其 API 帮助我们快速配置和执行常见的 JS 和 CSS 任务。需要注意的是,Laravel mix 在底层使用 webpack。
要运行 Laravel mix,请按照以下步骤操作
- 编辑
webpack.mix.js
文件并更新配置中 browsersync 的proxy : 'mini-framework.dev'
选项,以便实时查看更改而无需重新加载页面 - 在控制台执行
yarn
命令安装依赖 - 编译使用以下选项
yarn dev
开发yarn watch
开发和实时预览yarn prod
生产
JavaScript 个性化
默认情况下,mini framework 包含 vuejs、foundation、jquery、vee-validate 的依赖项。但这些不是必需的,可以轻松忽略它们,只加载所需的内容并适应你的工作流程。
要执行更改,我们需要修改以下文件 resources/assets/js/app.js
并注释掉不需要的部分。
关于 foundation,只加载了基本内容。如果你需要额外的插件,如手风琴、滑块等,需要在以下部分手动要求。
/** * We'll load jQuery and the Foundation framework which provides support * for JavaScript based foundation features such as modals and tabs. This * code may be modified to fit the specific needs of your application. */ try { window.$ = window.jQuery = require('jquery'); require('foundation-sites/dist/js/plugins/foundation.core.js'); require('foundation-sites/dist/js/plugins/foundation.util.mediaQuery.js'); //Example to include aditional plugin require('foundation-sites/dist/js/plugins/foundation.accordion.js'); require('foundation-sites/dist/js/plugins/foundation.util.keyboard.js'); } catch (e) {}
如果你使用 Vuejs
,你可以将组件组织在 resources/assets/js/components
中,默认情况下有一个用于加载 Vuejs 表单的组件 Form.vue
SASS 个性化
所有Sass文件都可以在resources/assets/sass/
目录中找到,同样,我们也可以根据需求定制Foundation,也就是说,可以在resources/assets/sass/foundation/_settings.scss
中更改默认配置,并包含额外的插件,因为和JavaScript一样,我们只加载Foundation的某些组件,取消注释ìnlcudes
中的内容在resources/assets/sass/foundation/_modules.scss
中,我们可以加载额外的组件。如果不使用Foundation,我们可以通过注释或删除resources/assets/sass/app.scss
中的以下部分来删除它。
//Foundation //@import "foundation/settings"; //@import "node_modules/foundation-sites/scss/foundation"; //@import "foundation/modules";
首页
打开项目后,您将看到两个表单,一个使用vuejs,另一个不使用vuejs,选择所需的一个,删除另一个以避免错误。
字体
为了加载自定义字体,请使用app.js
文件并编辑以下部分
/** * We'll load custom fonts with web font loader to improve page speed */ import WebFont from 'webfontloader'; WebFont.load({ google: { families: ['Open Sans:300,400,700'] } });
这样我们可以提高加载速度,更多信息请参阅web font loader
nota: Recordar actualizar la fuente en el archivo de configuración sass `resources/assets/sass/lib/_settings.scss`
安全漏洞或错误
如果您在这个迷你框架中发现安全漏洞,请发送电子邮件到tavo198718@gmail.com。所有安全漏洞都将尽快处理。或者打开一个issue来具体说明错误。
许可证
Mini-framework是一个遵循MIT许可证的开源软件。