caligrafy/caligrafy-quill

dev-master 2024-07-11 12:59 UTC

This package is auto-updated.

Last update: 2024-09-11 13:25:26 UTC


README

Caligrafy

什么是 Caligrafy

Caligrafy 是一个全新的 PHP MVC 框架,它从零开始构建,旨在为新手开发者提供简单优雅的方式来构建复杂和现代的 Web 应用程序。我们为安全、社交、电子商务、分析和机器学习等功能打下了坚实的基础,以便您将才华集中在您的想法上。

Caligrafy 将服务器端语言(如 PHP)的力量与客户端语言(如 JavaScript)的精致性相结合,向您展示如何构建最先进的 Web 功能。


Caligrafy 简介

在这段视频中,我们向您介绍了 Caligrafy 框架及其使用的不同组件。


要求

  • PHP > 7.2
  • MySql > 5.6
  • 您的服务器必须启用 curl、mbstring、openssl、mcrypt、gd、headers 和 redirect 模块

安装

快速安装


安装 Caligrafy

在这段视频中,我们向您介绍了 Caligrafy 框架及其使用的不同组件。


  • 从终端运行以下代码以获取 Caligrafy 的最新版本

    composer create-project -s dev caligrafy/caligrafy-quill <optionally specify a folder name. default: caligrafy-quill>
    
  • 从 Caligrafy 根目录运行以下代码以初始化框架

    php caligrafer.php initialize
    
    #or
    
    .bin/caligrafer initialize
    

    请注意,Caligrafer 初始化命令会中断所有 git 链接。

    • 如果您想为您的应用程序创建一个 git 仓库,建议您在初始化之后这样做。
    • 如果您从 Github 拉取了一个在 Caligrafy 中构建的应用程序,并且您想保留 git 连接以定期拉取更新,建议您进行手动安装。

  • 您已经准备好了!如果快速安装未成功完成,请进行手动安装

使用 Docker


使用 Docker 安装 Caligrafy

在这段视频中,我们向您展示如何无需设置任何开发环境即可安装和运行 Caligrafy。


以下两种方法都需要在您的本地计算机上安装 Docker。使用 Docker,您不再需要经历在本地安装 Apache 服务器来运行 PHP 和 MySQL 的麻烦。

  • 如果您在您的计算机上安装了 PHP 和 Composer,建议您首先进行 快速安装

  • 如果您没有 Composer,则可以从 github 拉取代码(您可以克隆仓库或下载 zip 文件)

  • 从 Caligrafy 根目录运行以下代码以启动 Caligrafy 服务器

    #if you have php
    php caligrafer.php server start
    
    #in all cases
    .bin/caligrafer server start
    
  • 启动后,您可以通过 https://:8080 在本地访问网站

  • 始终使用 server stop 替代 server start 来停止服务器

Docker 提供的数据库

  • 在这两个命令中,已经添加了一个 phpmyadmin 实例,可以在 https://:8077/ 访问。

  • 这是一个MySQL的Web客户端。它将允许您轻松访问数据库。

    • 用户名:root
    • 密码:root

手动安装

  • 从github获取代码(您可以选择克隆仓库或下载zip文件)
  • 建议将仓库放置在服务器文档根级别
  • 进入下载的仓库,通过复制示例创建一个 .env 文件:cp .env.example .env
  • 在 .env 文件中创建一个 APP_KEY 和一个 API_KEY。您可以通过运行 php caligrafer.php generatekeys 使用 Caligrafer 生成API密钥,并将生成的密钥添加到 .env 文件中
  • 如果不存在,请向 .env 文件中添加以下内容:APP_ROOT=<caligrafy根目录。默认:caligrafy-quill>。如果Caligrafy未安装在服务器文档根级别,请参阅不同根目录说明
  • 将 .env 文件中的其他值更改为匹配您的本地或生产服务器设置
  • 运行 composer install 以获取所有必需的依赖项
  • 通过运行以下命令初始化应用程序文件夹:cp -r framework/settings/application ./application
  • 如果您打算允许应用程序上传,请确保 /public/uploads/ 文件夹可写。您需要运行命令:sudo chmod -R 777 /public/uploads
  • 您已经准备好开始了!

安装测试

  • 您可以通过在浏览器中访问 https://:<服务器端口,默认80>/<caligrafy根目录。默认:caligrafy-quill> 来测试框架是否工作。

有关更高级的安装,请查看此处的文档。


为什么选择Caligrafy

1. 全栈框架

Caligrafy是一个全栈框架,利用服务器端语言(如PHP)和客户端语言(如JavaScript)的力量,帮助您构建强大而复杂的应用程序。

2. MVC架构

Caligrafy采用MVC架构模式构建,将业务逻辑与表示层分离。Caligrafy MVC建立了一系列方法和功能,确保业务层和表示层之间的关注点分离得到保持。

3. 现代模块化库

Caligrafy自带预包装的现代功能。在几行代码中,您就可以开始接受信用卡支付、ACH支付、加密货币支付、构建聊天机器人助手。一行代码就可以使您的应用程序具有丰富的结构化数据,并准备好进行社交分享。在很短的时间内,您的应用程序可以暴露REST-API供第三方应用程序使用。还有许多其他功能...

4. VueJS

Caligrafy支持VueJS作为其模板引擎的替代方案。VueJS在MVC架构的“视图”层中补充了Caligrafy创建强大且灵活的用户体验的能力。如果您是PHP开发者,Caligrafy使您能够轻松使用VueJS。如果您是JavaScript开发者,Caligrafy使您能够轻松地不被PHP所困扰。

5. AI和机器学习

Caligrafy在其核心集成了机器学习功能,帮助您无缝地将人工智能集成到应用程序中。

6. 模板引擎

Caligrafy有一个内置且功能强大的模板引擎,可以轻松创建复杂用户体验。

7. 轻量级语法

Caligrafy比其他框架更接近裸骨编程。虽然它提供了等效的甚至更强大的功能,但它从头开始为开发者而构建。

8. 文档和支持

Caligrafy致力于通过广泛的在线文档、YouTube频道的在线视频教程、Udemy上的培训课程以及通过Slack、Facebook和GitHub提供的实时帮助,为其开发者社区提供持续的支持。

依赖项

此框架使用几个第三方库,这些库已包含在发行版中

  • Phug (PHP Pug)用于创建强大的HTML视图和模板
  • GUMP验证用于提供简单且痛苦的数据验证和过滤
  • dotEnv用于提供为本地和生产服务器设置环境变量的能力
  • claviska/SimpleImage用于提供在服务器端对图像进行操作的能力
  • stripe/stripe-php用于支付功能
  • coinbase/coinbase-commerce用于加密支付功能

文档

学习Caligrafy

我们创建了一套严格的文档,以帮助您了解框架的基础知识,并尽可能快速地开始使用

  1. 入门

  2. 路由

  3. 请求

  4. 模型

  5. 关系

  6. 验证

  7. 视图

  8. 控制器

  9. 辅助工具、表单和REST API

  10. 身份验证

  11. Stripe和加密货币支付

  12. 元数据和丰富卡片

  13. 搜索引用和分析

Caligrafy和Vue.js

Caligrafy是一个现代MVC框架,它利用了M(模型)、V(视图)和C(控制器)中的强大技术。Vue.js是一个现代且渐进的JavaScript框架,它像Caligrafy一样从头开始构建。Vue.js使您能够创建强大且复杂的视图。此框架与Vue.js无缝集成,将PHP的最佳与JS的最佳相结合。


将Caligrafy与VueJS集成

在这段视频中,我们展示了VueJS可以以两种不同的方式与Caligrafy一起使用:1)作为库来构建简单的Web应用程序;2)作为一个完全集成的前端框架来构建大规模应用程序。


基础知识 - Vue.js作为库

在本节中,我们将介绍Vue.js的基础知识,并展示如何快速将其作为库使用。

  1. 设置Vue.js作为库
  2. 理解信息流
  3. 理解结构
  4. 路由
  5. 请求
  6. 表单
  7. 验证
  8. 组件

用于大规模应用程序

为了使用Vue构建大规模应用程序,我们需要利用Vue的强大功能,如单页应用程序(SPA)和单文件组件(SFC)。

  1. 设置Vue应用程序
  2. 单页应用程序的路由
  3. 单文件组件
  4. 状态管理

Caligrafy中的AI

Caligrafy提供简单的方法将人工智能和机器学习集成,以提供机器人、人脸检测和识别等功能。

  1. 使用Watson创建机器人
  2. 人脸检测和识别
  3. 机器学习
  4. OpenAI:ChatGPT、GPTs、DALL.E
  5. OpenAI:助手

学习Caligrafy

  • Caligrafy是一个优秀的教育框架。我们不断开发教学视频材料,以展示该框架的主要功能。请关注我们YouTube频道上的更多视频教程。

    Caligrafy频道

  • Caligrafy提供在线课程,为您提供了使用Caligrafy创建强大应用程序所需的所有基础知识。

    Caligrafy学院

与Caligrafy社区联系

Caligrafy社区有几种联系方式

  • github: 您可以使用github保持对Caligrafy路线图的最新了解,发布问题,并跟踪功能请求和问题的完成情况

  • slack: 加入我们的slack组是与其他社区成员交流、获取框架使用帮助以及讨论任何问题或功能的绝佳方式。

    加入我们的slack社区

  • facebook Caligrafy Group: 加入我们的facebook Caligrafy组让您有更多与社区互动和分享成功故事的方式。

    加入我们的facebook组

需要帮助开始吗?

当您需要我们时,我们一直在这里。如果您需要帮助开始,或需要帮助理解Caligrafy如何对您有用,我们可以提供帮助。通过加入我们的slack频道联系我们。 联系我们

让Caligrafy继续前进...

您的支持让我们继续前进。如果您喜欢Caligrafy,有几种方式可以做出贡献

  • 推广我们:在我们的网站上,您可以与您的朋友和粉丝分享我们的页面 caligrafy.com
  • 赞助我们:您可以通过多种方式在Github上赞助我们的工作。您的贡献可以帮助我们履行对开发社区的责任。 Github赞助
  • 资助我们的项目:您可以在Kickposter上资助我们的项目。Kickposter是一个使用Caligrafy早期版本构建的应用程序。