博客
docker 编排文件中限制内存配置如下 services: api: build: ./phpfpm hostname: bzj-api networks: hfnet: aliases: - bzj.api deploy: resources: limits: memory: 300M reservations: memory: 200M docker-compose 启动警告 WARNING: Some services (mysql, rsnmp) use the 'deploy' key, which will be ignored. Compose does not support 'deploy' configuration - use `docker stack deploy` to deploy to a swarm. 问题原因: 由于做了资源限制, 并且没有使用swarm, 所以要加上--compatibility参数, 不然会报错 解决方案在启动的时候,添加参数: docker-compose --compatibility up -d
11月前 喜欢(0) 浏览(508) 评论(0)
博客
通过配置路由,可以设置vue项目启动后默认显示的页面。路由的path设置为path:"/",启动项目后就会显示默认的组件页面。 import Vue from 'vue' import Router from 'vue-router' Vue.use(Router) import Home from '../components/Home.vue' import View from '../components/View.vue' import ViewTwo from '../components/ViewTwo.vue' export default new Router({ routes: [ { path:"/", // path 设置为 “/” ,默认显示该页面 component:Home, name:"Home" }, { path:"/view", component:View, name:"View" }, { path:"/viewtwo", component:ViewTwo, name:"ViewTwo" } ], mode:"history", // mode 设置为history ,去掉地址栏上的 # 号 })
11月前 喜欢(0) 浏览(581) 评论(0)
博客
Method invoked that should be only be invoked inside a doPrivileged block (DP_DO_INSIDE_DO_PRIVILEGED) 代码调用了一个需要安全权限检查的方法。如果代码需要被授权为安全权限,但是可能被不安全的代码去调用,那么classloader就需要放在doPrivileged块内。 This code invokes a method that requires a security permission check. If this code will be granted security permissions, but might be invoked by code that does not have security permissions, then the invocation needs to occur inside a doPrivileged block. 代码中field.setaccessible(true) 报了findbugs 解决方法是替换成 ReflectUtils.makeAccessible(field)
11月前 喜欢(0) 浏览(924) 评论(0)
博客
为什么要使用配置中心? 随着业务的发展,微服务架构的升级,服务的数量、应用的配置日益增多(各种微服务、各种服务器地址、各种参数),传统的配置文件方式和数据库的方式已经可能无法满足开发人员对配置管理的要求,同时对于配置的管理可能还会牵涉到 ACL 权限管理、配置版本管理和回滚、格式验证、配置灰度发布、集群配置隔离等问题,以及: 安全性:配置跟随源代码保存在版本管理系统中,容易造成配置泄漏 时效性:修改配置,需要每台服务器每个应用修改并重启服务 局限性:无法支持动态调整,例如日志开关、功能开关等 因此,我们可以通过一个配置中心以一种科学的管理方式来统一管理相关的配置。 安装 Aliyun ACM composer require hyperf/config-aliyun-acm 安装完成后,打开 config/autoload/aliyun_acm.php 配置文件 <?php return [ // 是否开启配置中心的接入流程,为 true 时会自动启动一个 ConfigFetcherProcess 进程用于更新配置 'enable' => true, // 配置更新间隔(秒) 'interval' => 5, // 阿里云 ACM 断点地址,取决于您的可用区 'endpoint' => env('ALIYUN_ACM_ENDPOINT', 'acm.aliyun.com'), // 当前应用需要接入的 Namespace 'namespace' => env('ALIYUN_ACM_NAMESPACE', ''), // 您的配置对应的 Data ID 'data_id' => env('ALIYUN_ACM_DATA_ID', ''), // 您的配置对应的 Group 'group' => env('ALIYUN_ACM_GROUP', 'DEFAULT_GROUP'), // 您的阿里云账号的 Access Key 'access_key' => env('ALIYUN_ACM_AK', ''), // 您的阿里云账号的 Secret Key 'secret_key' => env('ALIYUN_ACM_SK', ''), ]; 开通 ACM 服务 前提条件 您已注册阿里云账号并完成实名认证。 操作步骤 打开ACM 产品主页(https://www.aliyun.com/product/acm)。 在页面右上角单击登录。 在登录页面上输入您的阿里云账号和密码,并单击登录。登录成功后,您将跳转至 ACM 产品主页。 在产品主页上单击立即开通,然后在云产品开通页页面上勾选我已阅读并同意《应用配置管理服务协议》,并单击立即开通。 阿里云配置 在hyperf中添入阿里云ACM的配置 把对应信息配置到 aliyun_acm.php 中就 OK 了。 验证打印出 config('app_name')。 注意:你在 Aliyun ACM 中配置对应的参数,就会把本地的配置覆盖掉。
1年前 喜欢(0) 浏览(756) 评论(0)
置顶 博客
简介 Hyperf 是基于 Swoole 4.4+ 实现的高性能、高灵活性的 PHP 协程框架,内置协程服务器及大量常用的组件,性能较传统基于 PHP-FPM 的框架有质 的提升,提供超高性能的同时,也保持着极其灵活的可扩展性,标准组件均基于 PSR 标准 实现,基于强大的依赖注入设计,保证了绝大部分组件或类都是 可替换 与 可复用 的。 框架组件库除了常见的协程版的 MySQL 客户端、Redis 客户端,还为您准备了协程版的 Eloquent ORM、WebSocket 服务端及客户端、JSON RPC 服务端及客户端、GRPC 服务端及客户端、Zipkin/Jaeger (OpenTracing) 客户端、Guzzle HTTP 客户端、Elasticsearch 客户端、Consul 客户端、ETCD 客户端、AMQP 组件、Apollo 配置中心、阿里云 ACM 应用配置管理、ETCD 配置中心、基于令牌桶算法的限流器、通用连接池、熔断器、Swagger 文档生成、Swoole Tracker、视图引擎、Snowflake 全局 ID 生成器 等组件,省去了自己实现对应协程版本的麻烦。 Hyperf 还提供了 基于 PSR-11 的依赖注入容器、注解、AOP 面向切面编程、基于 PSR-15 的中间件、自定义进程、基于 PSR-14 的事件管理器、Redis/RabbitMQ 消息队列、自动模型缓存、基于 PSR-16 的缓存、Crontab 秒级定时任务、国际化、Validation 表单验证器 等非常便捷的功能,满足丰富的技术场景和业务场景,开箱即用。 框架初衷 尽管现在基于 PHP 语言开发的框架处于一个百家争鸣的时代,但仍旧未能看到一个优雅的设计与超高性能的共存的完美框架,亦没有看到一个真正为 PHP 微服务铺路的框架,此为 Hyperf 及其团队成员的初衷,我们将持续投入并为此付出努力,也欢迎你加入我们参与开源建设。 设计理念 Hyperspeed + Flexibility = Hyperf,从名字上我们就将 超高速 和 灵活性 作为 Hyperf 的基因。 对于超高速,我们基于 Swoole 协程并在框架设计上进行大量的优化以确保超高性能的输出。 对于灵活性,我们基于 Hyperf 强大的依赖注入组件,组件均基于 PSR 标准 的契约和由 Hyperf 定义的契约实现,达到框架内的绝大部分的组件或类都是可替换的。 基于以上的特点,Hyperf 将存在丰富的可能性,如实现 Web 服务,网关服务,分布式中间件,微服务架构,游戏服务器,物联网(IOT)等。 生产可用 我们为组件进行了大量的单元测试以保证逻辑的正确,同时维护了高质量的文档,在 Hyperf 正式对外开放之前,便已经过了严酷的生产环境的考验,我们才正式的对外开放该项目,至今,已有很多的大型/中小型互联网公司在生产环境使用 Hyperf。
1年前 喜欢(0) 浏览(1600) 评论(0)
博客
pid = run/php-fpm.pid pid设置,默认在安装目录中的var/run/php-fpm.pid,建议开启 error_log = log/php-fpm.log 错误日志,默认在安装目录中的var/log/php-fpm.log log_level = notice 错误级别. 可用级别为: alert(必须立即处理), error(错误情况), warning(警告情况), notice(一般重要信息), debug(调试信息). 默认: notice. emergency_restart_threshold = 60 emergency_restart_interval = 60s 表示在emergency_restart_interval所设值内出现SIGSEGV或者SIGBUS错误的php-cgi进程数如果超过 emergency_restart_threshold个,php-fpm就会优雅重启。这两个选项一般保持默认值。 process_control_timeout = 0 设置子进程接受主进程复用信号的超时时间. 可用单位: s(秒), m(分), h(小时), 或者 d(天) 默认单位: s(秒). 默认值: 0. daemonize = yes 后台执行fpm,默认值为yes,如果为了调试可以改为no。在FPM中,可以使用不同的设置来运行多个进程池。 这些设置可以针对每个进程池单独设置。 listen = 127.0.0.1:9000 fpm监听端口,即nginx中php处理的地址,一般默认值即可。可用格式为: ‘ip:port’, ‘port’, ‘/path/to/unix/socket’. 每个进程池都需要设置. listen.backlog = -1 backlog数,-1表示无限制,由操作系统决定,此行注释掉就行。backlog含义参考: http://www.3gyou.cc/?p=41 listen.allowed_clients = 127.0.0.1 允许访问FastCGI进程的IP,设置any为不限制IP,如果要设置其他主机的nginx也能访问这台FPM进程,listen处要设置成本地可被访问的IP。默认值是any。每个地址是用逗号分隔. 如果没有设置或者为空,则允许任何服务器请求连接 listen.owner = www listen.group = www listen.mode = 0666 unix socket设置选项,如果使用tcp方式访问,这里注释即可。 user = www group = www 启动进程的帐户和组 pm = dynamic #对于专用服务器,pm可以设置为static。 如何控制子进程,选项有static和dynamic。如果选择static,则由pm.max_children指定固定的子进程数。如果选择dynamic,则由下开参数决定: pm.max_children #,子进程最大数 pm.start_servers #,启动时的进程数 pm.min_spare_servers #,保证空闲进程数最小值,如果空闲进程小于此值,则创建新的子进程 pm.max_spare_servers #,保证空闲进程数最大值,如果空闲进程大于此值,此进行清理 pm.max_requests = 1000 设置每个子进程重生之前服务的请求数. 对于可能存在内存泄漏的第三方模块来说是非常有用的. 如果设置为 ’0′ 则一直接受请求. 等同于 PHP_FCGI_MAX_REQUESTS 环境变量. 默认值: 0. pm.status_path = /status FPM状态页面的网址. 如果没有设置, 则无法访问状态页面. 默认值: none. munin监控会使用到 ping.path = /ping FPM监控页面的ping网址. 如果没有设置, 则无法访问ping页面. 该页面用于外部检测FPM是否存活并且可以响应请求. 请注意必须以斜线开头 (/)。 ping.response = pong 用于定义ping请求的返回相应. 返回为 HTTP 200 的 text/plain 格式文本. 默认值: pong. request_terminate_timeout = 0 设置单个请求的超时中止时间. 该选项可能会对php.ini设置中的’max_execution_time’因为某些特殊原因没有中止运行的脚本有用. 设置为 ’0′ 表示 ‘Off’.当经常出现502错误时可以尝试更改此选项。 request_slowlog_timeout = 10s 当一个请求该设置的超时时间后,就会将对应的PHP调用堆栈信息完整写入到慢日志中. 设置为 ’0′ 表示 ‘Off’ slowlog = log/$pool.log.slow 慢请求的记录日志,配合request_slowlog_timeout使用 rlimit_files = 1024 设置文件打开描述符的rlimit限制. 默认值: 系统定义值默认可打开句柄是1024,可使用 ulimit -n查看,ulimit -n 2048修改。 rlimit_core = 0 设置核心rlimit最大限制值. 可用值: ‘unlimited’ 、0或者正整数. 默认值: 系统定义值. chroot = 启动时的Chroot目录. 所定义的目录需要是绝对路径. 如果没有设置, 则chroot不被使用. chdir = 设置启动目录,启动时会自动Chdir到该目录. 所定义的目录需要是绝对路径. 默认值: 当前目录,或者/目录(chroot时) catch_workers_output = yes 重定向运行过程中的stdout和stderr到主要的错误日志文件中. 如果没有设置, stdout 和 stderr 将会根据FastCGI的规则被重定向到 /dev/null . 默认值: 空.
1年前 喜欢(0) 浏览(1231) 评论(0)
博客
建议统一用 Model 封装做上传类。 功能尽量单一职责,只有一个上传功能。 如果非要添加其它字段的话,尽量添加一些简单的文字类字段。 上传后再生成一个ActiveRecord保存数据库。 这样子会避免许多麻烦。 个人见解,有好的方案大家分享分享。 以下是别人的方案,仅供参考 https://www.cnblogs.com/alanabc/p/9443391.html 第二种 解决方案 用切换场景来跳过某些检验。
1年前 喜欢(0) 浏览(1212) 评论(0)
博客
<script type="text/javascript"> var client=function(){ var engine={ //呈现引擎 trident:0, gecko:0, webkit:0, khtml:0, presto:0, ver:null //具体的版本号 }; var browser={ //浏览器 ie:0, firefox:0, safari:0, konq:0, opera:0, chrome:0, ver:null //具体的版本号 }; var system={ //操作系统 win:false, mac:false, x11:false }; var ua=navigator.userAgent; if(/AppleWebKit\/(\S+)/.test(ua)){ //匹配Webkit内核浏览器(Chrome、Safari、新Opera) engine.ver=RegExp["$1"]; engine.webkit=parseFloat(engine.ver); if(/OPR\/(\S+)/.test(ua)){ //确定是不是引用了Webkit内核的Opera browser.ver=RegExp["$1"]; browser.opera=parseFloat(browser.ver); }else if(/Chrome\/(\S+)/.test(ua)){ //确定是不是Chrome browser.ver=RegExp["$1"]; browser.chrome=parseFloat(browser.ver); }else if(/Version\/(\S+)/.test(ua)){ //确定是不是高版本(3+)的Safari browser.ver=RegExp["$1"]; browser.safari=parseFloat(browser.ver); }else{ //近似地确定低版本Safafi版本号 var SafariVersion=1; if(engine.webkit<100){ SafariVersion=1; }else if(engine.webkit<312){ SafariVersion=1.2; }else if(engine.webkit<412){ SafariVersion=1.3; }else{ SafariVersion=2; } browser.safari=browser.ver=SafariVersion; } }else if(window.opera){ //只匹配拥有Presto内核的老版本Opera 5+(12.15-) engine.ver=browser.ver=window.opera.version(); engine.presto=browser.opera=parseFloat(engine.ver); }else if(/Opera[\/\s](\S+)/.test(ua)){ //匹配不支持window.opera的Opera 5-或伪装的Opera engine.ver=browser.ver=RegExp["$1"]; engine.presto=browser.opera=parseFloat(engine.ver); }else if(/KHTML\/(\S+)/.test(ua)||/Konqueror\/([^;]+)/.test(ua)){ engine.ver=browser.ver=RegExp["$1"]; engine.khtml=browser.konq=parseFloat(engine.ver); }else if(/rv:([^\)]+)\) Gecko\/\d{8}/.test(ua)){ //判断是不是基于Gecko内核 engine.ver=RegExp["$1"]; engine.gecko=parseFloat(engine.ver); if(/Firefox\/(\S+)/.test(ua)){ //确定是不是Firefox browser.ver=RegExp["$1"]; browser.firefox=parseFloat(browser.ver); } }else if(/Trident\/([\d\.]+)/.test(ua)){ //确定是否是Trident内核的浏览器(IE8+) engine.ver=RegExp["$1"]; engine.trident=parseFloat(engine.ver); if(/rv\:([\d\.]+)/.test(ua)||/MSIE ([^;]+)/.test(ua)){ //匹配IE8-11+ browser.ver=RegExp["$1"]; browser.ie=parseFloat(browser.ver); } }else if(/MSIE ([^;]+)/.test(ua)){ //匹配IE6、IE7 browser.ver=RegExp["$1"]; browser.ie=parseFloat(browser.ver); engine.ver=browser.ie-4.0; //模拟IE6、IE7中的Trident值 engine.trident=parseFloat(engine.ver); } var p=navigator.platform; //判断操作系统 system.win=p.indexOf("Win")==0; system.mac=p.indexOf("Mac")==0; system.x11=(p.indexOf("X11")==0)||(p.indexOf("Linux")==0); if(system.win){ if(/Win(?:dows )?([^do]{2})\s?(\d+\.\d+)?/.test(ua)){ if(RegExp["$1"]=="NT"){ system.win = ({ "5.0" : "2000", "5.1" : "XP", "6.0" : "Vista", "6.1" : "7", "6.2" : "8", "6.3" : "8.1", "10" : "10" })[RegExp["$2"]] || "NT"; }else if(RegExp["$1"]=="9x"){ system.win="ME"; }else{ system.win=RegExp["$1"]; } } } return { ua:ua, //用户浏览器Ua原文 engine:engine, //包含着用户浏览器引擎(内核)信息 browser:browser,//包括用户浏览器品牌与版本信息 system:system //用户所用操作系统及版本信息 }; }(); var iehtml = '<div class="unwelcomeie">' + '<p class="tittle">抱歉!</p>'+ '<p class="tittle">当您看到这个页面的时候,说明您使用了<b><s>IE浏览器</s></b>。</p>' + '<p>本页面运用了大量的CSS3、HTML5的新特性。因此我们决定不支持IE以及使用IE内核的国产浏览器。</p>'+ '<p>想得到我们网站最佳访问效果,我们强烈建议您升级最新版的标准浏览器。比如以下推荐的浏览器。</p>' + '<ul>' + '<li>' + '<div><img src="/cpspew/html/img/chrome.png"></div>' + '<div><a href="http://rj.baidu.com/soft/detail/14744.html">chrome下载</a></div>' + '</li>' + '<li>' + '<div><img src="/cpspew/html/img/firefox.png"></div>' + '<div><a href="http://rj.baidu.com/soft/detail/11843.html">firefox下载</a></div>' + '</li>' + '<li>' + '<div><img src="/cpspew/html/img/opera.png"></div>' + '<div><a href="http://rj.baidu.com/soft/detail/11508.html">opera下载</a></div>'+ '</li>' + '</ul>' + '<div style="clear:both;"></div>' + '</div>'; if(client.browser.ie > 1 && client.browser.ie < 10){ document.body.innerHTML = iehtml; console.log(client.browser.ie) }else{ var afigcaption = document.getElementsByTagName('figcaption'); var arrUrl = ['http://kefu.qycn.com/vclient/chat/?websiteid=120097','http://kefu.qycn.com/vclient/chat/?websiteid=120097','http://shang.qq.com/wpa/qunwpa?idkey=1bf409d240f9bc081d5d034ad290a53e53f14188a73ca8533dd44b42e41486ef','http://kefu.qycn.com/vclient/chat/?websiteid=120097']; for(var i=0;i<afigcaption.length;i++){ afigcaption[i].index = i; afigcaption[i].onclick = function(){ window.open(arrUrl[this.index]); console.log(this.index); } } } </script>
2年前 喜欢(0) 浏览(1279) 评论(0)
博客
phpmyadmin切换远程数据库访问时需要更改 phpmyadmin\libraries\config.default.php下$【cfg['Servers'][$i]['host']='远程库的连接地址';】 phpmyadmin\config.inc.php下【$cfg['Servers'][$i]['host'] = '远程库的连接地址';】 作者:闷土豆先生 来源:CSDN 原文:https://blog.csdn.net/Frey_Ja/article/details/80484447 版权声明:本文为博主原创文章,转载请附上博文链接!
2年前 喜欢(0) 浏览(1441) 评论(0)
博客
if(navigator.appName == 'Microsoft Internet Explorer'){ if(navigator.userAgent.indexOf("MSIE 5.0")>0 || navigator.userAgent.indexOf("MSIE 6.0")>0 || navigator.userAgent.indexOf("MSIE 7.0")>0) { alert('您使用的 IE 浏览器版本过低, 推荐使用 Chrome 浏览器或 IE8 及以上版本浏览器.'); } }
2年前 喜欢(0) 浏览(1223) 评论(0)
博客
朋友fecshop 被人抢注了商标 几年努力打造的名气,最后形成的品牌被人捷足先登注册了 自己写开源软件的话,还是要搞个工商户去注册下商标 商标可以注册闲置不用,但是不可以让别人滥用。
2年前 喜欢(0) 浏览(1348) 评论(0)
博客
Yii2.0 RESTful API 之速率限制 什么是速率限制? 权威指南翻译过来为限流,为防止滥用,你应该考虑对您的 API 限流。 例如,您可以限制每个用户 10 分钟内最多调用 API 100 次。 如果在规定的时间内接收了一个用户大量的请求,将返回响应状态代码 429 (这意味着过多的请求)。 要启用速率限制,首先需要实现认证类,而关于认证的章节我在 Yii2.0 RESTful API 认证教程 进行了详细的阐述,本篇就不过多介绍,再次基础上进行操作 启用速率限制 翻阅权威指南,我们可以看到要启用速率限制首先 认证类 需要继承 yii\filters\RateLimitInterface 生成两个关键字段 php yii migrate/create add_allowance_and_allowance_updated_at_to_user 修改 刚才的迁移文件 /** * {@inheritdoc} */ public function safeUp() { $this->addColumn('user', 'allowance', $this->integer()); $this->addColumn('user', 'allowance_updated_at', $this->integer()); } /** * {@inheritdoc} */ public function safeDown() { $this->dropColumn('user', 'allowance'); $this->dropColumn('user', 'allowance_updated_at'); } 执行迁移 php yii migrate 编写认证类,并继承 RateLimitInterface namespace api\models; use Yii; use yii\base\NotSupportedException; use yii\behaviors\TimestampBehavior; use yii\db\ActiveRecord; use yii\filters\RateLimitInterface; use yii\web\IdentityInterface; class User extends ActiveRecord implements IdentityInterface,RateLimitInterface { . . . } 实现 RateLimitInterface 所需要的方法 public function getRateLimit($request, $action) { return [1, 1]; // $rateLimit requests per second } public function loadAllowance($request, $action) { return [$this->allowance, $this->allowance_updated_at]; } public function saveAllowance($request, $action, $allowance, $timestamp) { $this->allowance = $allowance; $this->allowance_updated_at = $timestamp; $this->save(); } 控制器中实现调用 use yii\filters\auth\CompositeAuth; use yii\filters\auth\HttpBearerAuth; use yii\filters\auth\QueryParamAuth; use yii\filters\RateLimiter; public function behaviors() { $behaviors = parent::behaviors(); $behaviors['rateLimiter'] = [ 'class' => RateLimiter::className(), 'enableRateLimitHeaders' => true, ]; $behaviors['authenticator'] = [ 'class' => CompositeAuth::className(), 'authMethods' => [ //Http::className(), HttpBearerAuth::className(), QueryParamAuth::className(), ], ]; //$behaviors['rateLimiter']['enableRateLimitHeaders'] = true; return $behaviors; } ok,请求下你的 action,多次请求如果出现 429,那么表示速率限制启用成功 以上就是关于 Yii2.0 速率限制的使用,速率限制需要和认证配合着使用,关于认证的,查阅Yii2.0 RESTful API 认证教程 ,这篇文章,推荐您,先看完认证,先做完认证的功能,然后在启用速率限制 关于 Yii2.0 RESTFul API到此我觉得就结束了,核心功能就是这些,剩下的就是具体的实战了,多练、多敲, 一共四篇文章,分别为: Yii2.0 RESTful API 基础配置教程 Yii2.0 RESTful API 认证教程 Yii2.0 RESTful API 之版本控制 Yii2.0 RESTful API 之速率限制
2年前 喜欢(1) 浏览(3306) 评论(2)
博客
Yii2.0 RESTful API 之版本控制 之前我写过两篇关于 Yii2.0 RESTful API 如何搭建,以及 认证 等处理,但是没有涉及到版本管理,今天就来谈谈版本管理如何实现。 索性就从头开始一步一步搭建吧,但是关于一些概念以及使用本篇就不一一解释了,可以参考 第一篇 Yii2.0 RESTful API 基础配置教程 进行配置 安装Yii2.0 通过 Composer 安装 这是安装Yii2.0的首选方法。如果你还没有安装 Composer,你可以按照这里的说明进行安装。 安装完 Composer,运行下面的命令来安装 Composer Asset 插件: composer global require "fxp/composer-asset-plugin:^1.2.0" 安装高级的应用程序模板,运行下面的命令: composer create-project yiisoft/yii2-app-advanced yii-api 2.0.14 拷贝backend目录,命名为api 打开api\config\main.php 修改id,controllerNamespace: return [ 'id' => 'app-api', 'basePath' => dirname(__DIR__), 'controllerNamespace' => 'api\controllers', ] 初始化高级模板 在初始化之前不妨先看下这篇文章 cd advanced php init 打开common\config\main.php开启url路由美化规则 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ ], ], 打开common\config\bootstrap.php添加以下别名 Yii::setAlias('@api', dirname(dirname(__DIR__)) . '/api'); ok,以上工作准备完毕,接下来进入正题, 关于版本更多介绍可以参考 权威指南 ,这里不过多解释(PS:主要我也不会......) 我的理解: Yii2 的版本你可以理解为不同的模块,每一个版本就是一个新的模块,比如常见的v1,v2等。 模块的搭建 关于如何生成模块,我们可以使用GII来进行生成. 配置 GII 打开 api/config/main-local.php 文件 修改如下: if (!YII_ENV_TEST) { // configuration adjustments for 'dev' environment $config['bootstrap'][] = 'debug'; $config['modules']['debug'] = [ 'class' => 'yii\debug\Module', ]; $config['bootstrap'][] = 'gii'; $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', 'allowedIPs' => ['127.0.0.1', '*'] ]; } 我这里因为使用的是 Homestead ,默认是不允许访问 GII 的,所以得加上'allowedIPs' => ['127.0.0.1', '*'] ,否则会出现 Forbidden (#403), 你可以根据自己的需要来进行配置,或者不配置 生成Modules 浏览器中输入 http://your host/gii ,可以看到 Module Generator ,点击 Start Modules Class 中输入:api\modules\v1\Module Module ID 中输入v1,(一般会自动输入) 点击 Preview 最后点击 Generate 进行生成 配置模块 打开 api/config/main.php 文件,修改 modules 'modules' => [ 'v1'=>[ 'class'=>'api\modules\v1\Module', ], ], 接着修改 urlManager 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'v1/default', 'extraPatterns'=>[ 'GET index'=>'index', ], ], ], ], 基于以上,Yii2.0 RESTFul API 就实现了版本管理,我们可以通过如下地址进行访问: http://localhost/v1/defaults 多说一点,我上方的地址是已经映射到api/web目录,请根据自己的实际情况进行配置 打开刚生成的 modules 文件目录,可以看到里面存在一个 v1 的目录,可以看到该目录还有一个controllers,以及一个 views 目录 ,我们刚才访问的 defaults 其实就是这两个文件,和传统的web项目一样控制器渲染视图 好了,你可能知道了,我们以后的控制器代码就放到 modules/v1/controllers 里了 刚才仅仅是默认GII为我们生成的代码,因为我们是API,所以 views 目录,我们一般情况下用不到。 新建一个 rest 的控制器 在 modules\v1\controllers 下新建 UserController <?php namespace api\modules\v1\controllers; use yii\rest\Controller; /** * User controller for the `v1` module */ class UserController extends Controller { /** * @return string */ public function actionIndex() { return 'this is v1/user'; } } 修改 api/config/main.php 中的urlManager 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'v1/default', 'extraPatterns'=>[ 'GET index'=>'index', ], ], ['class' => 'yii\rest\UrlRule', 'controller' => 'v1/user', 'extraPatterns'=>[ 'GET index'=>'index', ], ], ], ], 试着访问下 http://localhost/v1/users/index ok,以上就是 Yii2.0 版本管理的实现方式 格式化响应 修改 api/config/main.php 在components 数组中添加 response 'response' => [ 'class' => 'yii\web\Response', 'on beforeSend' => function ($event) { $response = $event->sender; $response->data = [ 'success' => $response->isSuccessful, 'code' => $response->getStatusCode(), 'message' => $response->statusText, 'data' => $response->data, ]; $response->statusCode = 200; }, ], 至此关于 Yii2.0 RESTFul API 我一共完成了 3 篇文章,分别为: Yii2.0 RESTful API 基础配置教程 Yii2.0 RESTful API 认证教程 Yii2.0 RESTful API 之版本控制 写得实在不怎么样,您如果看了有收获,不妨留言给个评论,或者您觉得写得有问题,或者不明白,也可以留言,我们可以一块探讨研究。
2年前 喜欢(2) 浏览(1969) 评论(1)
博客
Yii2.0 RESTful API 认证教程 隔了怎么长时间,终于到了 Yii2.0 RESTful API 认证介绍了. 废话不多说,直接正文开始 认证介绍 和Web应用不同,RESTful APIs 通常是无状态的, 也就意味着不应使用 sessions 或 cookies, 因此每个请求应附带某种授权凭证,因为用户授权状态可能没通过 sessions 或 cookies 维护, 常用的做法是每个请求都发送一个秘密的 access token 来认证用户, 由于 access token 可以唯一识别和认证用户,API 请求应通过 HTTPS 来防止man-in-the-middle (MitM) 中间人攻击. 认证方式 HTTP 基本认证 :access token 当作用户名发送,应用在access token可安全存在API使用端的场景, 例如,API使用端是运行在一台服务器上的程序。 请求参数: access token 当作API URL请求参数发送,例如 https://example.com/users?access-token=xxxxxxxx, 由于大多数服务器都会保存请求参数到日志, 这种方式应主要用于JSONP 请求,因为它不能使用HTTP头来发送 access token OAuth 2 : 使用者从认证服务器上获取基于 OAuth2 协议的 access token, 然后通过 HTTP Bearer Tokens 发送到 API 服务器。 上方进行简单介绍,内容来自 Yii Framework 2.0 权威指南 实现步骤 我们都知道 Yii2.0 默认的认证类都是 User,前后台都是共用一个认证类,因此我们要把API 认证类 单独分离出来,达到前、后、API都分离, 继上一章:(这里暂时使用默认User数据表,正式环境请分离不同的数据表来进行认证) 准备条件 继上篇的 User 数据表,我们还需要增加一 个access_token 的字段, 1. 直接在你的数据库中新增 access_token 字段。 2. 使用数据迁移的方式 * 进入项目根目录打开控制台输入以下命令: php yii migrate/create add_access_token_to_user * 打开 你的项目目录/console/migrations/m180704_054630_add_access_token_to_user.php 修改如下内容: ``` public function safeUp() { $this->addColumn('user', 'access_token', $this->string()); } public function safeDown() { $this->dropColumn('user', 'access_token'); } ``` * 执行迁移命令 ``` php yii migrate ``` 浏览器打开前台目录 frontend 页面,点击注册账号,先注册一个账号 配置 打开 api\config\main.php 配置 user 应用组件: * 设置 `identityClass` 属性为哪个认证类 * 设置 `enableSession` 属性为 `false` * 设置 `enableAutoLogin` 属性为 `true` 将 session 组件注释掉,或删掉 'user' => [ 'identityClass' => 'api\models\User', 'enableAutoLogin' => true, 'enableSession'=>false, //'identityCookie' => ['name' => '_identity-backend', 'httpOnly' => true], ], //'session' => [ // this is the name of the session cookie used for login on the backend // 'name' => 'advanced-backend', // ], 编写 api\models\User.php 实现认证类,继承 IdentityInterface 将 common\models\User 类拷贝到 api\models\目录下,修改命名空间为api\models <?php namespace api\models; use Yii; use yii\base\NotSupportedException; use yii\behaviors\TimestampBehavior; use yii\db\ActiveRecord; use yii\web\IdentityInterface; ... class User extends ActiveRecord implements IdentityInterface { ... ... } 将 common\models\LoginForm.php 类拷贝到api\models\目录下,修改命名空间,并重写login方法: <?php namespace api\models; use Yii; use yii\base\Model; ... ... public function login() { if ($this->validate()) { $access_token=$this->_user->generateAccessToken(); $this->_user->save(); return $access_token; } else { return false; } } 上方代码给User模型添加了一个generateAccessToken()方法,因此我们到api\models\User.php中添加此方法 namespace api\models; use Yii; use yii\base\NotSupportedException; use yii\behaviors\TimestampBehavior; use yii\db\ActiveRecord; use yii\web\IdentityInterface; ... ... class User extends ActiveRecord implements IdentityInterface { ... ... /** * 生成accessToken字符串 * @return string * @throws \yii\base\Exception */ public function generateAccessToken() { $this->access_token=Yii::$app->security->generateRandomString(); return $this->access_token; } } 接下来打开 之前的User 控制器编写登录方法 use api\models\LoginForm; ... ... //省略一些代码 /** * 登陆 * @return array * @throws \yii\base\Exception * @throws \yii\base\InvalidConfigException */ public function actionLogin() { $model = new LoginForm(); if ($model->load(Yii::$app->getRequest()->getBodyParams(), '') && $model->login()) { return [ 'access_token' => $model->login(), ]; } else { return $model->getFirstErrors(); } } ... 最后新增一条URL规则 打开 api\config\main.php 修改 components属性,添加下列代码: 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'user', 'extraPatterns'=>[ 'POST login'=>'login', ], ], ], ] 使用一个调试工具来进行测试 http://youdomain/users/login 记住是POST 请求发送,假如用POSTMAN有问题的话指定一下 Content-Type:application/x-www-form-urlencoded。 ok,不出意外的话,相信你已经可以收到一个access_token了,接下来就是如何使用这个token,如何维持认证状态,达到不携带这个token将无法访问,返回401 维持认证状态 实现认证只需两步: 在你的 REST 控制器类中配置 authenticator 行为来指定使用哪种认证方式 在你的 user identity class 类中实现 yii\web\IdentityInterface::findIdentityByAccessToken() 方法. 接下来我们围绕这两步来实现: 添加一个REST控制器 因我这里暂未设计其他数据表 所以我们暂且还使用User 数据表吧 在api\controllers\新加一个控制器 命名为 ArticleController 并继承 yii\rest\ActiveController,配置认证方式代码:代码如下: <?php namespace api\controllers; use yii\rest\ActiveController; use Yii; use yii\filters\auth\CompositeAuth; use yii\filters\auth\HttpBasicAuth; use yii\filters\auth\HttpBearerAuth; use yii\filters\auth\QueryParamAuth; class ArticleController extends ActiveController { public $modelClass = 'api\models\User'; public function behaviors() { $behaviors = parent::behaviors(); $behaviors['authenticator'] = [ 'class' => CompositeAuth::className(), 'authMethods' => [ HttpBasicAuth::className(), HttpBearerAuth::className(), QueryParamAuth::className(), ], ]; return $behaviors; } } 注意:这个控制器并非真正的Article,实则还是User 实现 findIdentityByAccessToken() 方法: 打开 api\models\User.php 重写 findIdentityByAccessToken() 方法 ... ... class User extends ActiveRecord implements IdentityInterface { ... ... public static function findIdentityByAccessToken($token, $type = null) { return static::findOne(['access_token' => $token]); } ... } 为刚才新加的控制器添加路由规则(ps:好像多了一步......) 修改 api\config\main.php 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'user', 'extraPatterns'=>[ 'GET send-email'=>'send-email' 'POST login'=>'login', ], ], ['class' => 'yii\rest\UrlRule', 'controller' => 'article', 'extraPatterns'=>[ ], ], ], ] 接下来访问一下你的域名 http://youdomain/articles,不携带任何参数是不是返回 401了? ok,这里介绍两种访问方式,一种是URL访问,另一种是通过header 来进行携带 http://youdomain/articles?access-token=y3XWtwWaxqCEBDoE-qzZk0bCp3UKO920 传递 header头信息 Authorization:Bearer y3XWtwWaxqCEBDoE-qzZk0bCp3UKO920 注意 Bearer 和你的token中间是有 一个空格的,很多同学在这个上面碰了很多次 好啦,基于YII2.0 RESTful 认证就此结束了, 更过完整的功能 请移步官方文档 授权验证 另外还有速率验证,就自行发觉吧 另外,如果看不懂,或者写的不好,请移步 魏曦 老师的视频教程,本人所有内容都是跟随 魏曦老师 学的 魏曦教你学 写完认证发现我们的接口返回的数据不是很直观,现实生活中通常也不是这样子的,我们可能会返回一些特定的格式 自定义响应内容 打开 api\config\main.php 在 components数组里面添加如下内容分 'response' => [ 'class' => 'yii\web\Response', 'on beforeSend' => function ($event) { $response = $event->sender; $response->data = [ 'success' => $response->isSuccessful, 'code' => $response->getStatusCode(), 'message' => $response->statusText, 'data' => $response->data, ]; $response->statusCode = 200; }, ], 这里的状态码统一设为 200 ,具体的可另行配置,假如登陆操作 密码错误或者其他,我们可以在控制器中这样使用: $response = Yii::$app->response; $response->setStatusCode(422); return [ 'errmsg' => '用户名或密码错误!' ]; 水平有限,难免有纰漏,请不吝赐教,在下会感激不尽
2年前 喜欢(0) 浏览(1932) 评论(0)
博客
Yii2 RESTful API 快速搭建教程 这篇说下yii2.0开发 API 吧,使用 RESTful API模式 安装Yii2.0 通过 Composer 安装 这是安装Yii2.0的首选方法。如果你还没有安装 Composer,你可以按照这里的说明进行安装。 安装完 Composer,运行下面的命令来安装 Composer Asset 插件: php composer.phar global require "fxp/composer-asset-plugin:^1.2.0" 安装高级的应用程序模板,运行下面的命令: php composer.phar create-project yiisoft/yii2-app-advanced advanced 2.0.13 初始化高级模板 cd advanced init 修改数据库连接属性 打开 common\config\main-local.php,配置数据库连接信息 'db' => [ 'class' => 'yii\db\Connection', 'dsn' => 'mysql:host=127.0.0.1;dbname=yiiapi', 'username' => 'root', 'password' => 'root', 'charset' => 'utf8', ], 执行 migrate 数据库迁移 yii migrate 拷贝backend目录,命名为api 打开api\config\main.php 修改id,controllerNamespace: return [ 'id' => 'app-api', 'basePath' => dirname(__DIR__), 'controllerNamespace' => 'api\controllers', ] 打开common\config\main.php开启url路由美化规则 'urlManager' => [ 'enablePrettyUrl' => true, 'showScriptName' => false, 'rules' => [ ], ], 打开common\config\bootstrap.php添加以下别名 Yii::setAlias('@api', dirname(dirname(__DIR__)) . '/api'); 配置 Web 服务器 很多同学在看了我这个教程,说是运行不起来、一直是404,然后就问我为什么?我看了好多,他们都是本地使用 Apache ,并且 index.php 文件没有隐藏,他们访问地址也不叫 index.php。所以在此说明一下吧 Apache 配置 # 设置文档根目录为 "path/to/api/web" DocumentRoot "path/to/api/web" <Directory "path/to/api/web"> # 开启 mod_rewrite 用于美化 URL 功能的支持(译注:对应 pretty URL 选项) RewriteEngine on # 如果请求的是真实存在的文件或目录,直接访问 RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d # 如果请求的不是真实文件或目录,分发请求至 index.php RewriteRule . index.php # if $showScriptName is false in UrlManager, do not allow accessing URLs with script name RewriteRule ^index.php/ - [L,R=404] # ...其它设置... </Directory> 或者 在web 目录下新建一个 .htaccess 文件,填入以下内容(我这是从 Laravel 项目中拷贝过来的),同样可以起到隐藏 index.php 的效果 <IfModule mod_rewrite.c> <IfModule mod_negotiation.c> Options -MultiViews -Indexes </IfModule> RewriteEngine On # Handle Authorization Header RewriteCond %{HTTP:Authorization} . RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] # Redirect Trailing Slashes If Not A Folder... RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_URI} (.+)/$ RewriteRule ^ %1 [L,R=301] # Handle Front Controller... RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] </IfModule> Nginx 的配置 location / { # Redirect everything that isn't a real file to index.php try_files $uri $uri/ /index.php$is_args$args; } 为什么要单独创建API应用 单独创建API应用,目的是便于维护,可以避免以下问题 配置的冲突 控制器的命名不便 url美化规则冲突 分工明确frontend为前台目录;backend为后台目录;api为api目录 接下来打开 api\controllers 新建一个User控制器,继承 yii\rest\ActiveController,命名为 UserController,代码如下: <?php namespace api\controllers; use yii\rest\ActiveController; class UserController extends ActiveController { public $modelClass = 'common\models\User'; } 这里创建 user控制器继承 yii\rest\ActiveController 并指定要操作的模型 启用JSON 输入 配置 request 应用程序组件的 parsers 属性使用 yii\web\JsonParser 用于 JSON 输入 打开配置文件 api\config\main-local.php 修改为如下代码: <?php $config = [ 'components' => [ 'request' => [ // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation 'cookieValidationKey' => 'P0r2XoT9LCUnyVlSgxBbJOqQxdCJ3i29', 'parsers' => [ 'application/json' => 'yii\web\JsonParser', ], ], ], ]; if (!YII_ENV_TEST) { // configuration adjustments for 'dev' environment $config['bootstrap'][] = 'debug'; $config['modules']['debug'] = [ 'class' => 'yii\debug\Module', ]; $config['bootstrap'][] = 'gii'; $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', ]; } return $config; 配置URL规则 为刚才的 user控制器添加url美化规则 打开 api\config\main.php 修改 components属性,添加下列代码: ... 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'user' ], ], ] ... ok,到此就成了一个 符合 RESTful 风格的API 看起来在控制器了什么也没有写,只是指定了一个模型,但是她的背后完成了很多的功能哦,列表如下: GET /users: 逐页列出所有用户 HEAD /users: 显示用户列表的概要信息 POST /users: 创建一个新用户 GET /users/123: 返回用户 123 的详细信息 HEAD /users/123: 显示用户 123 的概述信息 PATCH /users/123: and PUT /users/123: 更新用户123 DELETE /users/123: 删除用户123 OPTIONS /users: 显示关于末端 /users 支持的动词 OPTIONS /users/123: 显示有关末端 /users/123 支持的动词 如何访问呢 你可以使用 curl命令进行访问,命令如下: curl -i -H "Accept:application/json" "http://localhost/users" 命令行下还是比较麻烦的,也不方便测试,推荐使用 API测试工具 这类的工具有很多,我就不一一列举了,这里推荐 Postman,很好很强大,Chorme也有插件,可以安装,这里我推荐直接下载软件安装调试,比较方便 你可能发现了 访问任何路由地址都是加的s,users , 为什么呢? 资源,你要理解 资源二字,既然是资源肯定是个集合,肯定有一大堆,所以要加上复数,我是这么理解的。 你说我就是不想加上s,我就想采用http://localhost/user 这种方式来进行访问,好吧,可以,满足你,只是不推荐 继续打开配置文件api\config\main.php修改刚才添加的 urlManager 如下: 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'user', 'pluralize' => false, //设置为false 就可以去掉复数形式了 ], ], ] 加入 'pluralize' => false, 就表示去掉复数形式了,再次强调不推荐 ok,在控制器中我们没有写任何一句代码,他就给我们生成许多方法,但是有时候我们可能需要修改一些代码,来达到我们想要的效果,比如连表查询,然后再返回数据 接下来我们就实现这样的功能: 打开刚才新建的user控制器, 重写 action方法: <?php namespace api\controllers; use yii\rest\ActiveController; class UserController extends ActiveController { public $modelClass = 'common\models\User'; public function actions() { $action= parent::actions(); // TODO: Change the autogenerated stub unset($action['index']); unset($action['create']); unset($action['update']); unset($action['delete']); return $action; } public function actionIndex() { //你的代码 } } 这样我们就可以重写他的代码了。哈哈 我们再新建一个自己的 action <?php namespace api\controllers; use yii\rest\ActiveController; class UserController extends ActiveController { public $modelClass = 'common\models\User'; public function actions() { $action= parent::actions(); // TODO: Change the autogenerated stub unset($action['index']); unset($action['create']); unset($action['update']); unset($action['delete']); return $action; } public function actionIndex() { //你的代码 } public function actionSendEmail() //假如是get请求 { //业务逻辑 } } 然后试着访问一下 http://localhost/users/send-email,报错?找不到? 报错就对了,那是因为我们没有设置其他路由访问 修改 api\config\main.php 'urlManager' => [ 'enablePrettyUrl' => true, 'enableStrictParsing' => true, 'showScriptName' => false, 'rules' => [ ['class' => 'yii\rest\UrlRule', 'controller' => 'user', //'pluralize' => false, //设置为false 就可以去掉复数形式了 'extraPatterns'=>[ 'GET send-email'=>'send-email' ], ], ], ] 接下来重新访问就没有问题了,ps:你自己编写的任何 action 都要在 extraPatterns 进行配置 差点忘了 状态码 这个东西,我们现在所有的东西返回来的都是一个 JSON,加入没有数据局返回的是空的数组,所以这肯定不行啊,我们得加上 一些特定的状态码 来标识这些数据啊,怎么加? 继续修改 api\config\main.php 在 components 添加如下代码: 'response' => [ 'class' => 'yii\web\Response', 'on beforeSend' => function ($event) { $response = $event->sender; $response->data = [ 'success' => $response->isSuccessful, 'code' => $response->getStatusCode(), 'message' => $response->statusText, 'data' => $response->data, ]; $response->statusCode = 200; }, ], 这里统一使用 200来表示,当然并不是所有的都是 200,你应该具体情况具体对待,切记不要乱使用 任意加各种标识,请 遵循这些 规范 状态码 是不是觉得还少了点什么?认证 对就是 认证,就差 认证 就完美了,篇幅有限,内容多了反而影响阅读兴趣,下篇进行 认证介绍 感谢以下,特别是 魏曦老师的视频教程 魏曦教你学 Yii Framework 2.0 权威指南 不足之处,欢迎指正
2年前 喜欢(0) 浏览(3557) 评论(0)
博客
作为一个屌丝级别的开发者对接别人的api也是一个常见的事情。 比如有以下一个api需要对接 接口地址:http://api.qingyunke.com/api.php?key=free&appid=0&msg=关键词      key 固定参数free      appid 设置为0,表示智能识别,可忽略此参数      msg 关键词,请参考下方参数示例,该参数可智能识别,该值请经过 urlencode 处理后再提交 返回结果:{"result":0,"content":"内容"}      result 状态,0表示正常,其它数字表示错误      content 信息内容 对接接口第一步封装一个能用于请求http的工具类, components/helper/CurlHelper.php namespace components\helper; class CurlHelper extends \yii\base\Object { public static function get($url,$data){ $curl = curl_init(); $o = ""; foreach ( $data as $k => $v ) { $o.= "$k=" . urlencode( $v ). "&" ; } $data = substr($o,0,-1); $url = $url.'?'.$data; curl_setopt($curl, CURLOPT_URL, $url); // 要访问的地址 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0); // 对认证证书来源的检查 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在 //curl_setopt($curl, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); // 模拟用户使用的浏览器 curl_setopt($curl, CURLOPT_FOLLOWLOCATION, 1); // 使用自动跳转 curl_setopt($curl, CURLOPT_AUTOREFERER, 1); // 自动设置Referer curl_setopt($curl, CURLOPT_TIMEOUT, 30); // 设置超时限制防止死循环 curl_setopt($curl, CURLOPT_HEADER, 0); // 显示返回的Header区域内容 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // 获取的信息以文件流的形式返回 $tmpInfo = curl_exec($curl); // 执行操作 curl_close($curl); // 关闭CURL会话 return $tmpInfo; } } components为根目录下的一个文件夹,里面用于存放自己定义的类,YII2时MVC结构,没有建议用户的自定义类放哪里,而vendor目录很多第三方的活雷锋库,最为一个自私的开发者。所有得自定义一个文件夹用于放自己定义的class,题外话”components“的叫法来自一个没我帅的人,我不会告诉大家他叫【谁偷了汝的凶兆】,也有人把自定义的class放libs的,由于我是Java过来的半吊子,觉得这样叫不太妥当。所有采用了”components“的叫法,总之大家开心就好。 对这个库进行配置 config/web.php $config = [ ... 'aliases' => [ '@components' => '@app/components' ],..]; 封装一下api components/qingyunke/FeiFei.php namespace components\qingyunke; use components\helper\CurlHelper; use yii\base\Object; use yii\helpers\Json; /** * Created by PhpStorm. * User: 16487 * Date: 2018/5/8 * Time: 9:47 */ class FeiFei extends Object { const API_URL='http://api.qingyunke.com/api.php'; const API_KEY='free'; const APP_ID='0'; public static function sendMessage($msg){ $data = [ 'key' => self::API_KEY, 'appid' =>self::APP_ID, 'msg' => $msg ]; try { $infoStr = CurlHelper::get(self::API_URL, $data); if ($infoStr != null) { $mjson = Json::decode($infoStr, false); if ($mjson->result == 0) { $mContent=$mjson->content; $mContent=str_replace("{br}","\n",$mContent); $mContent=str_replace("请发送","请回复",$mContent); return $mContent; } } } catch (\Exception $e) { } return null; } } 测试api commands/HelloController.php namespace app\commands; ... class HelloController extends Controller { ... public function actionQwe() { var_dump(FeiFei::sendMessage("我是大帅哥")); } ... } cd 到yii目录执行 D:\www\foxhome>yii hello/qwe 得到响应
2年前 喜欢(1) 浏览(1911) 评论(0)
置顶 博客
介绍 变更概述 Yii3 composer 包 运行您的第一个 Yii3 驱动的应用程序 介绍 本文档适用于已熟悉Yii2的读者。 这意味着将所有与Yii 3相关的信息集中在一个地方,以便更容易走上正轨。 Yii 3是Yii框架的第二次重写。 最初从2.1分支开始,后来因为所有向后兼容性破坏而决定切换到3.X系列。 从3.0开始,Yii将遵循Sementic Versionning。 这个重写解决了Yii 2遭受的许多问题,比如框架与jQuery,bower,bootstrap相结合。 [TODO:添加更多关于Yii2的grieff] 变更概述 以下是Yii 3中的主要更改。您可以查看完整的CHANGELOG以获取详尽的列表。 源代码分裂 框架源代码已被拆分为多个包,并且在其核心级别,Yii不再对您的开发堆栈或您将使用的功能进行假设。 这使您可以选择组成应用程序所需的软件包。 这种重组也是维护的好消息,因为这些包将单独发布,从而允许更频繁的更新。 自动加载 已删除自定义PHP类自动加载器,以支持 Composer 的 PSR-4 实现。 这意味着为了让Yii看到你的类,你必须在 composer.json 中显式注册你的命名空间。 我们稍后会看到一个例子。 PSR兼容性 通过实现以下PSR,Yii 3在 PHP-FIG 建议之后采取了一些积极的步骤: 现在,日志记录符合PSR-3 缓存现在符合PSR-16 依赖注入现在符合PSR-11 应用配置 如果您曾经使用Yii 2安装了扩展程序,您可能/当然已经找到了自己的扩展 README 文件,在您自己的config/ main.php文件中查找要复制/粘贴的配置块。 这通常会导致: 一个巨大的配置文件(您可能决定将其拆分为较小的文件) 当使用新的/更改的配置选项重新发布新版本的扩展时,将更新非平凡配置。 Yii3 采用了另一种方法。 每个软件包捆绑自己的配置,可能会开箱即用。 如果需要,您可以从配置文件中覆盖它们。 这一切都是通过利用 hiqdev/composer-config-plugin composer插件完成的,该插件在您运行 composer dump-autoload(也称为composer du)时负责扫描和合并所有配置。 您可以阅读 Yii2 projects alternative organization,以深入解释 hiqdev/composer-config-plugin 背后的动机。 软件包作者将有责任通过严格的版本化版本来避免引入BC中断。 依赖注入 ... Yii3 composer 包 以下是Yii 3中引入的新软件包,可在此官方列表中找到。 我们简要介绍一下: 框架 yiisoft/yii-core 这是Yii的新内核。 它定义了基本框架及其核心功能,如行为,i18n,邮件,验证... 您很少想直接安装 yiisoft/yii-core。 相反,您将安装以下一项或多项: yiisoft/yii-console yiisoft/yii-web yiisoft/yii-rest 这三个包被视为扩展,负责实现它们所指的每个“通道”的基本功能: yii-console 实现了构建控制台应用程序所需的一切(命令的基本控制器,命令助手,...) yii-web 实现了构建Web应用程序所需的一切(资产管理,会话,请求处理..) yii-rest 实现了构建REST接口所需的一切(ActiveController,..) 库 在Yii 3中,库不依赖于Yii,并且可以在框架之外使用。 他们的包名是 yiisoft/ 没有yii-prefix的东西。 yiisoft/log:日志库 yiisoft/di:依赖注入库 yiisoft/cache:缓存库 yiisoft/active-record:Active Record库 yiisoft/rbac:角色基本访问控制库 yiisoft/view:视图渲染库 yiisoft/mutex:互斥锁实现 yiisoft/db:数据库库 yiisoft/db 的驱动程序 DB的各种驱动程序也已分为包: yiisoft/db-mysql MySQL支持Yii yiisoft/db-mssql 对Yii的MSSQL支持 yiisoft/db-pgsql PostgreSQL支持Yii yiisoft/db-sqlite 对Yii的SQLite支持 yiisoft/db-oracle Oracle 数据库支持 yiisoft/db-sphinx Sphinx支持 yiisoft/db-redis Redis支持 yiisoft/db-mongodb MongoDB支持 yiisoft/db-elasticsearch Elatic 支持 扩展 扩展取决于(至少)yii-core。 除了上面已经遇到的3个扩展(yii-console,yii-web,yii-api),这些包都可用 开发环境扩展 yiisoft/yii-debug 调试面板 yiisoft/yii-gii 代码生成器扩展 yiisoft/yii-dev 用于框架贡献者的工具 页面渲染扩展 yiisoft/yii-twig Twig Extension 数据渲染 yiisoft/yii-dataview:ListView,GridView,DetailView JS&CSS框架集成 yiisoft/yii-bootstrap3:Bootstrap3 资源和小部件 yiisoft/yii-bootstrap4:Bootstrap4 资源和小部件 yiisoft/yii-jquery jQuery,ActiveForm 小部件 yiisoft/yii-captcha CAPTCHA扩展 yiisoft/yii-masked-input:屏蔽输入小部件(取决于jquery) 杂项 yiisoft/yii-swiftmailer Swift Mailer Extension yiisoft/yii-http-client HTTP客户端扩展 yiisoft/yii-auth-client 外部身份验证扩展 Yii项目模板和基础应用程序 yiisoft/yii-project-template 这是一个非常基本的Yii项目模板,您可以使用它来开始开发。 您可能希望选择这三个启动器中的一个或多个以在下一个项目中安装: yiisoft/yii-base-cli yiisoft/yii-base-web yiisoft/yii-base-api 让我们尝试在下一节中运行Web基础模板。 运行您的第一个 Yii3 驱动的应用程序 让我们尝试使用 Yii3 和提供的项目模板运行Web应用程序。 安装项目模板 composer create-project --prefer-dist --stability=dev yiisoft/yii-project-template myapp cd myapp 这是创建的结构: . ├── LICENSE ├── README.md ├── composer.json ├── composer.lock ├── config │ ├── common.php │ └── params.php ├── docker-compose.yml ├── hidev.yml ├── public │ ├── assets │ ├── favicon.ico │ ├── index.php │ └── robots.txt ├── runtime └── vendor 您将无法使用./vendor/bin/yii serve 立即启动Web服务器,因为它会抱怨不知道“app”类。 实际上,此项目模板仅在您的应用程序中引入最低限度:缓存,依赖项注入和日志记录。 模板不会对您正在构建的应用程序类型(web,cli,api)做出假设。 你可以从头开始使用这个裸模板,选择你想要使用的扩展和包并开始开发,或者你可以选择提供的三个启动器中的一个。 安装Web启动器 由于我们正在进行Web应用程序,因此我们需要一个资产管理器。 我们可以选择其中一个: Asset-packagist和composer-merge-plugin(仅需要PHP) Foxy (要求 npm 或 yarn) 让我们选择Foxy(个人品味,因为composer 来自 Tunisia 的速度很慢): composer require "foxy/foxy:^1.0.0" 我们现在可以安装 yii-base-web 启动器并运行我们的应用程序: composer require yiisoft/yii-base-web vendor/bin/yii serve 通过访问 http://localhost:8080/ 您现在应该看到如下内容: 检查我们的项目结构,除了创建这三个条目之外,没有什么真正改变: node_modules/ package-lock.json package.json 那么我们在浏览器中看到的内容来自哪里? 探索 yiisoft/yii-base-web结构: 如果您浏览vendor/yiisoft/yii-base-web中的文件夹,您将看到该模板实际上是一个项目本身,具有以下结构: . ├── LICENSE.md ├── README.md ├── composer.json ├── config │ ├── common.php │ ├── console.php │ ├── env.php │ ├── messages.php │ ├── params.php │ └── web.php ├── phpunit.xml.dist ├── public │ └── css │ └── site.css ├── requirements.php ├── runtime └── src ├── assets │ └── AppAsset.php ├── commands │ └── HelloController.php ├── controllers │ └── SiteController.php ├── forms │ ├── ContactForm.php │ └── LoginForm.php ├── mail │ └── layouts ├── messages │ ├── et │ ├── pt-BR │ ├── ru │ └── uk ├── models │ └── User.php ├── views │ ├── layouts │ └── site └── widgets └── Alert.php 如果您已经使用Yii2和基本模板开发了应用程序,那么文件夹和文件应该对您有意义。
精华贴
2年前 喜欢(4) 浏览(20943) 评论(11)
博客
场景 网站 https 已经成为一种趋势,那么作为个人站长如何用廉价的方式使自己的网站实现 https?阿里云推出了免费 SSL 证书,是众多个人站长的福音,那么我们就以阿里云作为示例,来演示一下如何实现全站 https 。 购买免费的 SSL 证书 推荐在域名购买的账户进行购买SSL证书(可以免去很多认证的步骤)。 注意啊,上面可不是让你买收费证书。因为免费证书默认看不到,请按图中红字和箭头进行选择: 1. 先选Symantec 2. 选1个域名 就会变成下图了 然后购买完成即可。详细申请步骤 nginx 配置 在证书控制台下载 Nginx 版本证书。下载到本地的压缩文件包解压后包含: 在Nginx的安装目录下创建cert目录,并且将下载的全部文件拷贝到cert目录中。如果申请证书时是自己创建的CSR文件,请将对应的私钥文件放到cert目录下并且命名为a.key; 打开 Nginx 安装目录下 conf 目录中的 nginx.conf 文件,找到: # HTTPS server # #server { # listen 443; # server_name localhost; # ssl on; # ssl_certificate cert.pem; # ssl_certificate_key cert.key; # ssl_session_timeout 5m; # ssl_protocols SSLv2 SSLv3 TLSv1; # ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP; # ssl_prefer_server_ciphers on; # location / { # # #} #} 将其修改为 (以下属性中ssl开头的属性与证书配置有直接关系,其它属性请结合自己的实际情况复制或调整) : server { listen 443; server_name www.yii-china.com; ssl on; root /var/www; # 项目根目录 index index.php index.html index.htm; location / { try_files $uri $uri/ @rewrite; } location @rewrite { rewrite ^(.*)$ /index.php$1 last; } ssl_certificate cert/a.pem; ssl_certificate_key cert/a.key; ssl_session_timeout 5m; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_prefer_server_ciphers on; location ~ \.php { fastcgi_pass 127.0.0.1:9000; include fastcgi_params; fastcgi_split_path_info ^(.+?\.php)(.*)$; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param PATH_REANSLATED $document_root$fastcgi_path_info; } } 然后设置一下http 自动转 https server { listen 80; server_name www.yii-china.com; rewrite ^(.*) https://$server_name$1 permanent; ... 以上操作即可实现全站 https 。
2年前 喜欢(2) 浏览(2853) 评论(4)
博客
目的 通过了解binlog日志的相关配置,简单掌握通过binlog对数据库进行数据恢复操作; mysql 日志文件 任何成熟软件都会有一套成熟的日志系统,当软件出现问题时,这些日志就是查询问题来源的宝库。同样,mysql也不例外,也会有一系列日志记录mysql的运行状态。 mysql主要有以下几种日志: 错误日志:记录mysql运行过程中的错误信息 一般查询日志:记录mysql正在运行的语句,包括查询、修改、更新等的每条sql 慢查询日志:记录查询比较耗时的SQL语句 binlog日志:记录数据修改记录,包括创建表、数据更新等 这些日志均需要在my.cnf文件进行配置,如果不知道mysql的配置文件路径,可以使用mysql命令进行查找, mysql --verbose --help|grep -A 1 'Default options’ #该命令会罗列出my.cnf顺序查找的路径。 binlog日志 binlog就是binary log,二进制日志文件,记录所有数据库更新语句,包括表更新和记录更新,即数据操纵语言(DML),binlog主要用于数据恢复和配置主从复制等; 数据恢复:当数据库误删或者发生不可描述的事情时,可以通过binlog恢复到某个时间点的数据。 主从复制:当有数据库更新之后,主库通过binlog记录并通知从库进行更新,从而保证主从数据库数据一致; mysql按照功能分为服务层模块和存储引擎层模块,服务层负责客户端连接、SQL语句处理优化等操作,存储引擎层负责数据的存储和查询;binlog属于服务层模块的日志,即引擎无关性,所有数据引擎的数据更改都会记录binlog日志。当数据库发生崩溃时,如果使用InnoDB引擎,binlog日志还可以检验InnoDB的redo日志的commit情况。 binlog日志开启 日志开启方式: 1、添加配置 log_bin=ON log_bin_basename=/path/bin-log log_bin_index=/path/bin-log.index 2、仅仅设置log-bin参数 log-bin=/path/bin-log 当开启binlog日志之后,mysql会创建一个 log_bin_index指定的 .index 文件和多个二进制日志文件,index中按顺序记录了mysql使用的所有binlog文件。binlog日志则会以指定的名称(或默认值) 加自增的数字作为后缀,ex:bin-log.000001,当发生下述三种情况时,binlog日志便会进行重建: 文件大小达到max_binlog_size参数的值 执行 flush logs命令 重启mysql服务 binlog 日志格式 通过参数binlog_format参数的值,可以设置binlog的格式,可选值有 statement、row、mixed * statement格式:记录数据库执行的原始SQL语句 * row格式:记录具体的行的修改,这个为目前默认值 * mixed格式:因为上边两种格式各有优缺点,所以就出现了mixed格式 binlog日志查看工具:mysqlbinlog 因为binlog是二进制文件,不能像其他文件一样,直接打开查看。但mysql提供了binlog查看工具mysqlbinlog,可以解析二进制文件。当然不同格式的日志解析结果是不一样的; 1. statement格式日志,执行mysqlbinlog /path/bin-log.000001,可以直接看到原始执行的SQL语句 2. row格式日志,则可读性没有那么好,但仍可通过参数使文档更加可读 mysqlbinlog -v /path/bin-log.000001 mysqlbinlog两对非常重要的参数 1. --start-datetime --stop-datetime 解析某一个时间段内的binlog; 2. --start-position --stop-position 解析在两个position之间的binlog; 使用binlog恢复数据: 使用binlog恢复数据,本质上就是通过binlog找到所有DML操作,去掉错误的SQL语句,然后重走一遍长征路,就可以将数据恢复; 线下实操: 创建数据表并插入初始值 CREATE TABLE `users` ( `id` int(11) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(255) DEFAULT NULL, `age` int(8) DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4; INSERT INTO `users` (`id`, `name`, `age`) VALUES (null, '姓名一', 5); 找到上一次全量备份的数据库和binlog的position(ps:当然也可以通过时间进行恢复)。此处以目前状态作为备份的初始值, mysqldump -uroot -p T > /path/xxx.sql; # 备份数据库 show master status; # 查看当前的position位置,此时值为154 插入多条记录 INSERT INTO `users` (`id`, `name`, `age`) VALUES (null, '姓名二', 13), (null, '姓名三', 14), (null, '姓名四', 15), (null, '姓名五', 16), (null, '姓名六', 17); 进行误操作,并且在误操作之后又插入几条数据 update users set age = 5; INSERT INTO `users` (`id`, `name`, `age`) VALUES (null, '姓名七', 16), (null, '姓名八', 18); 发现误操作之后,进行数据恢复,首先停止mysql对外的服务,利用备份数据恢复到上次数据; 通过mysqlbinlog命令对二进制文件进行分析,分析发现 误操作发生在position为706位置,且上次正常操作的结束位置在513 在1152到结尾位置有正常执行的SQL执行 通过mysqlbinlog命令从binlog日志中导出可执行的SQL文件,并将数据导入到mysql mysqlbinlog --start-position=154 --stop-position=513 bin-log.000001 > /path/bak.sql; mysql -uroot -p < /path/bak.sql; 跳过错误的更新语句,再通过步骤7的逻辑把后续正常语句重新跑一遍,完成数据恢复工作 小结 无论什么时间,数据库发生崩溃都会令人愁眉紧锁,心烦意乱。binlog可以说是在各种情况下,数据库崩溃、数据丢失之后的一粒后悔药,本文通过线下环境,简单的对数据库进行了一次数据恢复实验,如有不对,还请指教 参考文章 http://www.ywnds.com/?p=12839 https://zhuanlan.zhihu.com/p/33504555
2年前 喜欢(2) 浏览(1916) 评论(0)
博客
改动 就像当初 Yii2.0 时代降临 Yii1.0 终将灰暗,Yii3.0 版本推出势必掀起 Yii 框架的波澜,那么Yii3.0 相比 Yii2.0 究竟做了哪些改动呢? 一睹为快:Yii3.0 版本改动 Yii3.0 框架简介 Yii3.0 框架是一个骨架应用程序,最适合快速创建项目。 该框架包含基本功能,包括用户登录/注销和联系页面。它包括所有常用配置,使您可以专注于为应用程序添加新功能。 目录结构 config/ 包含应用配置 public/ 包含入口脚本,已发布的资源和其他公开可用的文件,例如favicon.ico和robots.txt runtime/ 包含运行时生成的文件 vendor/ 包含依赖的第三方包 .env .env.dist composer.json docker-compose.yml 要求 Web服务器支持PHP 7.1 是 Yii3.0 框架的最低要求。 安装 如果您没有 Composer,可以按照 getcomposer.org 上的说明进行安装。 然后,您可以使用以下命令安装此项目模板: composer create-project --prefer-dist --stability = dev yiisoft / yii-project-template myapp cd myapp 这为您提供了一个空项目,您可以添加应用程序模板,请参阅以下有关如何添加这些项目的部分。 根据您的系统,您可能需要为./runtime和./public/assets提供写入权限 CLI 应用 如果要安装运行自己的控制台命令所需的控制台应用程序,可以通过加载yiisoft / yii-base-cli 软件包来实现。 composer require yiisoft/yii-base-cli 您现在可以运行yii help来查看可用的命令。 API 应用 如果要创建API,可以通过加载 [yiisoft / yii-base-api](https://github.com/yiisoft/yii-base-api)包来实现 composer require yiisoft/yii-base-api vendor/bin/yii serve -p 8081 您可以通过http:// localhost:8081 /访问API。 Web 应用 由于Web应用程序使用客户端资源(例如CSS和Javascript),因此首先选择资源分配系统 方案a:Asset-packagist和composer-merge-plugin(只需要PHP) composer require "wikimedia/composer-merge-plugin" composer config repositories.ap '{"type": "composer", "url": "https://asset-packagist.org"}' composer config extra.merge-plugin.include "vendor/*/*/composer.assets.json" 方案b:Foxy (需要 npm 或者 yarn) composer require "foxy/foxy:^1.0.0" 现在,您可以安装Web应用程序库及其依赖项 composer require yiisoft/yii-base-web vendor/bin/yii serve 现在您应该可以通过http://localhost:8080/访问该应用程序。 您可以在 GitHub 上找到更多可用的应用程序库。 Docker 克隆存储库并创建环境配置文件 cp .env.dist .env 要运行安装,请从PHP映像创建bash docker-compose run --rm php bash 并运行上面的composer命令。 启动应用程序堆栈 docker-compose up -d 通过浏览器访问 http://docker.host:30080 配置 数据库 编辑数据库配置文件config/db.php,并添加真实的配置,例如: return [ 'class' => 'yii\db\Connection', 'dsn' => 'mysql:host=localhost;dbname=yii2basic', 'username' => 'root', 'password' => '1234', 'charset' => 'utf8', ]; 提示: - Yii不会为您创建数据库,必须先手动完成,然后才能访问它。 - 检查并编辑config /目录中的其他文件,根据需要自定义应用程序。 - 有关基本应用程序测试的信息,请参阅tests目录中的README。 测试 测试位于tests目录中。 直接从Docker镜像运行 docker run -it -v $PWD/yii-project:/app -w /app yiisoftware/yii2-php:7.2-apache bash
精华贴
2年前 喜欢(2) 浏览(10209) 评论(5)
社区公告
[公告] Yii中文网为优化用户体验进行大版本升级,老版网站会维持一段时间,可以点击顶部"旧版"链接访问旧版网站。
沟通交流

:492175201(技术1群)

:183620600(技术2群)

:291010569(技术3群)

订阅号 | 更多精彩内容推送
本周推荐