skygreen2001 / betterlife

1.0.0 2021-12-07 04:33 UTC

Requires

• php: >=5.2.0
• adodb/adodb-php: >=5.19
• fusonic/linq: ^2.0
• mustangostang/spyc: ^0.6.2
• nelexa/zip: ^3.1
• phpoffice/phpspreadsheet: ^1.2
• smarty/smarty: ^3.1

Requires (Dev)

• pagon/composer-packer: 0.1.x

GPL-3.0-or-later

• skygreen2001

• framework
• php
• api
• cms
• BB

Published on Packagist.org on 2021-12-07 04:35 UTC

README

符合中国开发者思维方式的快速开发的框架，设计初衷快捷、简单、实用。

它包括一套实用的通用模版、后台管理模版，并根据项目的需要，按照数据库的设计一键生成定制化的代码框架。

它自定义了一套快速开发报表的工具、Redis管理工具、数据库运维工具以协助快速开发。

本框架主要研发全栈式开发模式的可行性方案以及进行的实践。

AI时代最重要的代码生成原则:

“Code in English, Comment in Chinese.” (注释用中文，代码用英语。)

Talk is cheap. Show me the code. —— Linus Torvalds 代码稀缺的时代，代码即意图的证明。

Code is cheap. Show me the prompt. —— V2EX AI 生产代码的时代，意图成为真正的稀缺。

Code is cheap. Comments are the prompts that survived. 当代码廉价，注释就是幸存下来的 prompt。 prompt 生成代码，代码迭代百次，prompt 烟消云散——唯有沉淀进代码库的那份意图，成为注释。注释是穿越了时间存活下来的提示词，是意图的存档。既然它是 prompt 的最终形态，就该用 prompt 该有的语言来写——你思考的语言。

运动的正式命名

《码英注汉公约》（The CEC Convention） Code in English, Comment in Chinese. 一条默认，两种自由：默认中文注释，原生开发则由个人所好随思进行配置。

三条公理（理论骨架）

1. 对端公理：语言由对端决定。代码的对端是机器与全球生态，故用英文；注释的对端是读者头脑，故用读者信息密度最高的语言。
2. 禀赋公理：英文长于名——标识符、语法形态、百年生态词汇；中文长于意——意合结构、最高字符信息熵、四字达意。让每种语言只做它最擅长的事。
3. 时代公理：AI 使写代码的成本趋零，代码库的全部成本集中到读上。过去英语能力是编程的隐形门槛，如今 AI 的英文比任何人都标准——这道门被替所有人打开了，而中文注释，是门后为你留的路标。

宣言（可署名版）

《码英注汉宣言》

代码写给机器与天下，故循英文； 注释写给自己与未来，故用中文。

三十年前，Linus 说：Talk is cheap. Show me the code. 三年间，我们说：Code is cheap. Show me the prompt. 今天，AI 替我们写下所有英文，人类剩下的全部工作是阅读与决断。 而注释，是幸存下来的 prompt。

为此我们倡议，一切 AI 代码工具的出厂默认： Code in English, Comment in Chinese.

英文立码之形，中文凝注之神； 代码从世界，注释从读者。

为什么关键是“出厂标配”而非“最佳实践”

让每一家 AI 编码工具在配置文件里写下这一行：

comment_language: zh-CN  # CEC default

收束成一句，作为整个方法论的最后压缩：

让英文去编译，让中文去解释。 Let English compile. Let Chinese explain.

帮助文档

• 学习手册
  • 学习手册: 在Surge
  • 学习手册: 在Netlify
• 快速上手
• Zread

下载源码

• 下载地址: https://gitee.com/skygreen2015/betterlife

• Git安装

  • 下载Git

    • Git SCM : https://git-scm.com/downloads
    • Bitbucket: https://www.atlassian.com/git/tutorials/install-git
    • Git大全 : https://gitee.com/all-about-git

  • 下载betterlife

    > git clone https://gitee.com/skygreen2015/betterlife
    或
    > git clone https://github.com/skygreen2001/betterlife.git
    或
    > git clone https://github.com.cnpmjs.org/skygreen2001/betterlife
    

  • 安装Git客户端工具

    • sourcetree
    • GitKraken
    • GitHub Desktop
    • tortoiseGit

• Docker安装

  • 下载 Docker

  • 下载betterlife

    > docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git clone https://gitee.com/skygreen2015/betterlife
    或
    > docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git clone https://github.com/skygreen2001/betterlife.git
    或
    > docker run -ti --rm -v ${HOME}:/root -v $(pwd):/git alpine/git clone https://github.com.cnpmjs.org/skygreen2001/betterlife
    

• Composer安装

  • 下载betterlife

    > composer create-project skygreen2001/betterlife betterlife
    

通常安装

安装运行环境

以下工具任选一种即可

• ampps

  可以直接在它上面下载安装(Wamp|Lamp|Mamp)

• Xampp

  XAMPP是完全免费且易于安装的Apache发行版，其中包含MariaDB、PHP和Perl。

• Wamp

  Windows下的Apache + Mysql + PHP [PhpStudy]: http://www.phpstudy.net/

• Lamp

  LAMP指的Linux、Apache，MySQL和PHP的第一个字母 [安装详细说明]: http://blog.csdn.net/skygreen_2001/article/details/19912159

• Mamp

  Mac环境下搭建 Apache/Nginx、MySQL、Perl/PHP/Python 平台。

• Laravel Valet

  • Valet中文文档

• 宝塔

• PhpStudy

• 本地运行PHP server: php -S localhost:80

安装检查

• PHP安装检查

其它安装

• 安装PHP第三方库和UEditor

  • 安装PHP第三方库主要是用composer
  • 后台【admin】在线编辑器使用百度的UEditor组件，需按该文档说明进行安装。

• [安装示例数据库]

  • 新建Mysql数据库:betterlife, 运行脚本: install/db/mysql/db_betterlife.sql

Docker安装

如果开发者熟悉Docker或者希望尝试通过Docker搭建开发环境(无需考虑因为操作系统，无法完整搭建应用运行环境，如在Mac操作系统下，因为权限问题无法安装php的zip或者redis，Mac Monterey版本后不再默认安装PHP), 可使用Docker安装

• 安装Docker

  • Get Docker

• Docker帮助文档

  • 帮助文档

• Docker 运行应用

  • 根路径下运行以下指令执行操作

  • 创建运行: docker-compose up -d

  • 运行应用: docker-compose start

  • 停止应用: docker-compose stop

  • 进入应用: docker exec -it bb /bin/bash

  • 删除所有的容器: docker-compose down

  • 删除生成的镜像: docker rmi bb_nginx bb mysql:5.7

• 安装后需知

  • 需知说明

• 云平台

  • 阿里云
  • Heroku
  • vagrant: https://segmentfault.com/a/1190000000264347

框架目录定义

• core : 框架核心支持文件

• taglib : 自定义标签，您也可以在自己的应用中定义自定义标签

• install: 安装目录

• misc : 引用第三方Js、Css、Image、Fonts资源目录

• tools : 开发项目中通常用到的工具，包括项目重用工具、代码生成工具、消除整站文件BOM头工具、压力测试工具等

• home : 应用目录，Web应用层所有代码都放在这里，每一个Web应用是一个子目录。 (每个应用目录名称需在Gc.php里的变量:$module_name里注册)

  • admin : 后台管理
  • model : 通用模版
  • report : 报表系统
  • betterlife: 网站前台

• api : ajax请求服务端服务支持[手机或Web前端ajax请求返回json数据]

• app :

  • html5: 自适应html5Web网页[内嵌在手机App里]
  • redis: Redis系统数据监控工具

• log : 日志目录，每天一个调试测试日志文件放在这里

• upload : 后台上传文件(如图片、pdf)放置目录

• docs : 框架帮助说明文档

• 重要的二级目录说明

  • core/config : 配置文件[各个功能模块]
  • core/util : 常用的工具类
  • core/include : 常用的函数库
  • install/db : 框架数据库备份包括测试数据
  • install/library : 自定义功能模块
  • api/mobile : 手机端ajax请求服务端返回json数据
  • api/web : Pc端ajax请求服务端返回json数据
  • upload/images : 上传图片放置路径
  • upload/attachment: 批量导入/导出数据文件(如excel)放置目录

开发工具

• TRAE SOLO CN
• Visual Studio Code
• Atom
• Atom IDE
• Sublime

参考资料

• 帮助文档源码
• PHP The Right Way
• 学习与收集
• 本框架早期帮助文档