phalapi
PhalApi 2.23.2
النطق: PAI Framework ، الموقع الرسمي: https://www.phalapi.net/
يمكن لمستندات التطوير الأنيقة والمفصلة التي تم إعدادها خصيصًا لـ Phper العثور على الإجابات التي تريدها في الوثائق. يرجى الاطلاع على: وثائق تطوير Phalapi 2.x.
استخدم Composer لإنشاء أمر مشروع لتحقيق تثبيت نقرة واحدة.
$ composer create-project phalapi/phalapiتذكير دافئ: لاستخدام الملحن ، يرجى الرجوع إلى موقع Composer الصيني/حزم الصين على نطاق واسع.
بدلاً من ذلك ، يمكن تنفيذ التثبيت اليدوي. بعد تنزيل وإزالة ضغط رمز مشروع GIT هذا ، قم بإجراء تحديث ملحن اختياري ، أي:
$ composer updateإذا كنت تستخدم NGINX ، فيمكنك الرجوع إلى التكوين التالي.
server {
listen 80 ;
server_name dev.phalapi.net;
# 将根目录设置到public目录
root /path/to/phalapi/public;
charset utf-8;
location / {
index index.php;
}
location ~ .php$ {
fastcgi_split_path_info ^(.+.php)(/.+)$ ;
# 根据当前环境，选择合适的通讯方式
# fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name ;
}
}عند التكوين ، تحتاج إلى تعيين الدليل الجذر للموقع على الدليل العام ، وإعادة تشغيل Nginx بعد حفظ التكوين.
تذكير دافئ: من المستحسن توجيه مسار جذر الوصول إلى/to/to/phalapi/public.
كيفية استخدام قاعدة بيانات MySQL ، راجع تعديل تكوين قاعدة بيانات ./config/dbs.php .
return array (
/**
* DB数据库服务器集群 / database cluster
*/
' servers ' => array (
' db_master ' => array ( // 服务器标记 / database identify
' type ' => ' mysql ' , // 数据库类型，暂时只支持：mysql, sqlserver / database type
' host ' => ' 127.0.0.1 ' , // 数据库域名 / database host
' name ' => ' phalapi ' , // 数据库名字 / database name
' user ' => ' root ' , // 数据库用户名 / database user
' password ' => '' , // 数据库密码 / database password
' port ' => 3306 , // 数据库端口 / database port
' charset ' => ' UTF8 ' , // 数据库字符集 / database charset
' pdo_attr_string ' => false , // 数据库查询结果统一使用字符串，true是，false否
' driver_options ' => array ( // PDO初始化时的连接选项配置
// 若需要更多配置，请参考官方文档：https://www.php.net/manual/zh/pdo.constants.php
),
),
),
// 更多代码省略……
);أخيرًا ، تحتاج إلى إضافة أذونات الكتابة إلى دليل وقت التشغيل. لمزيد من تعليمات التثبيت ، يرجى الرجوع إلى الوثائق للتنزيل والتثبيت.
في Phalapi ، يمكنك تحديد خدمة الواجهة التي سيتم استدعاؤها من خلال معلمة الخدمة (الاسم القصير هو المعلمة S). على سبيل المثال ، الوصول إلى خدمة الواجهة الافتراضية.
http://dev.phalapi.net/?s=App.Site.Index
إخراج النتيجة بعد طلب الواجهة يشبه ما يلي:
{
"ret": 200,
"data": {
"title": "Hello PhalApi",
"version": "2.4.2",
"time": 1501079142
},
"msg": ""
}
رمز PHP المقابل موجود في ملف ./SRC/APP/API/SITE.PHP ، وشظية رمز المصدر هي كما يلي:
<?php
namespace App Api ;
use PhalApi Api ;
/**
* 默认接口服务类
* @author: dogstar <[email protected]> 2014-10-04
*/
class Site extends Api {
public function getRules () {
return array (
' index ' => array (
' username ' => array ( ' name ' => ' username ' , ' default ' => ' PhalApi ' , ' desc ' => '用户名' ),
),
);
}
/**
* 默认接口服务
* @desc 默认接口服务，当未指定接口服务时执行此接口服务
* @return string title 标题
* @return string content 内容
* @return string version 版本，格式：X.X.X
* @return int time 当前时间戳
* @exception 400 非法请求，参数传递错误
*/
public function index () {
return array (
' title ' => ' Hello ' . $ this -> username ,
' version ' => PHALAPI_VERSION ,
' time ' => $ _SERVER [ ' REQUEST_TIME ' ],
);
}
}تأثير العملية على النحو التالي:
سيقوم Phalapi تلقائيًا بإنشاء مستندات واجهة عبر الإنترنت في الوقت الفعلي بناءً على تكوين المعلمة وتعليقات التعليمات البرمجية للواجهة التي كتبتها. رابط مستند الواجهة عبر الإنترنت هو:
تأثير التصفح يشبه ما يلي:
يشبه تأثير صفحة تفاصيل وثيقة الواجهة ما يلي:
يدعم اختبار الواجهة عبر الإنترنت ، وطلب أوصاف العينة ، وإنشاء مستندات واجهة HTML دون اتصال ، والتحديثات في الوقت الفعلي.
./phalapi
├── README.md # 简介
├── bin # 脚本目录
├── config # 配置目录
│ ├── app.php # 应用配置
│ ├── dbs.php # 数据库配置
│ ├── di.php # 依赖服务配置
│ └── sys.php #系统配置
├── data # 数据库
│ └── phalapi.sql # 数据库安装时的文件
├── language # 翻译包
├── public # 对外访问的目录
│ ├── docs # 离线生成的HTML接口文档
│ ├── docs.php # 在线版接口文档访问入口
│ ├── index.php
│ ├── init.php # 全局初始化文件
│ ├── static # 静态资源
│ ├── uploads # 上传目录（需要有写入权限）
│ └── phalapi_logo.png # logo图片
├── runtime # 运行目录
│ ├── cache # 文件缓存
│ └── log # 文件日志
├── sdk # SDK包
├── src # 项目源代码，非常重要
│ ├── app # 接口源代码（遵循ADM模式）
│ │ ├── Api # 放置接口源代码，相当于控制器层
│ │ ├── Common # 公共代码目录，放置工具等
│ │ ├── Domain # 领域业务层，负责业务逻辑和处理
│ │ ├── functions.php # 公共函数库
│ │ └── Model # 数据源层，负责数据持久化存储及操作
│ └── view # 页面模板目录（如接口文档）
├── tests # 单元测试
└── vendor # composer包，不需要手动修改，通过composer install/update可进行安装和更新 تعديل ملف ./public/init.php لتعيين اللغة الحالية.
// 翻译语言包设定-简体中文
PhalApi SL ( ' zh_cn ' );
// Setting language to English
PhalApi SL ( ' en ' );
تذكير دافئ: يجب تثبيت الامتداد أعلاه من خلال الملحن قبل الاستخدام. لمزيد من المعلومات حول استخدام وتطوير مكتبات الصف الممتد ، يرجى الرجوع إلى المستند: مكتبة فئة التمديد Phalapi Framework.
تذكير دافئ: الفرق بين المكونات الإضافية للتطبيق والملحقات الملحمية هو أن المكونات الإضافية للتطبيق أكثر تفصيلاً ولديها وظائف أكثر تحديدًا. قد لا يكون لديهم فقط قواعد بيانات وواجهات وواجهات ، ولكن أيضًا يتعاونون مع المحطات الأخرى ، ولا يخضعون لمواصفات الملحن. هم طريقة التطوير للاختراع والتصميم المستقل لفالابي. لمزيد من المعلومات ، يرجى الرجوع إلى: البرنامج التعليمي لتطوير تطبيق الجهات الخارجية.
تذكير دافئ: تستخدم جميع المنتجات المذكورة أعلاه إطار المصدر المفتوح Phalapi ويتم تطويره بشكل مستقل من قبل المسؤول. الأفراد/الفرق/المؤسسات مرحب بها لاستخدامها.
إذا وجدت أي مشاكل ، أو أي مشاكل ، فيرجى تقديم مشكلة هنا.
إذا أردت ، الرجاء مساعدتي في إعطائي نجمة على Github أو Mayun ، ويمكنك أيضًا التبرع بـ Phalapi^_^.
Apache 2.0 ، ترخيص Apache هو بروتوكول اعتمده Apache ، وهي منظمة شهيرة غير ربحية مفتوحة المصدر. يشبه هذا البروتوكول BSD ، ويشجع أيضًا مشاركة الكود ويحترم حقوق الطبع والنشر للمؤلف الأصلي ، ويسمح بتعديل الكود وإعادة نشر (كمصدر مفتوح أو برنامج تجاري).
تم الحفاظ عليها وترقيتها بواسطة Guangzhou Guochuang Network Technology Co. ، Ltd. لفترة طويلة.
