今天看到老java用的swagger提供接口,美观好用,方便维护,不是写好接口之后再写接口文档,麻烦的要死.网上找了找结合php的方法,在此记录一下,以后再开发接口就可以方便很多了. Swagger的使用目的是方便优美的呈现出接口API的各种定义, 生成API文档, 包括参数, 路径之类. 有时后端改了API的参数或者其他设置, 前端直接看这个Swagger UI就可以, 方便项目管理和团队协作. swagger-ui的原理 安装Swagger套件, 然后php文件代码里写注释, 用Swagge

安装TP5遇到这样的错误 TP5安装失败怎么办? [Mon Mar 13 06:24:58.011228 2017] [:error] [pid 10243] [client 192.168.28.1:49237] PHP Warning: require(/var/www/tp5/public/../thinkphp/start.php): failed to open stream: No such file or directory in /var/www/tp5/public/index

1: lnmp : https://lnmp.org/install.html  官网安装帮助 运行命令:wget http://soft.vpser.net/lnmp/lnmp1.6.tar.gz -cO lnmp1.6.tar.gz && tar zxf lnmp1.6.tar.gz && cd lnmp1.6 && ./install.sh lnmp  重要两项:选择mysql 版本 5.7, 选择php版本 :7.2 2:先把远程mysql 3306

官网:http://swagger.io/ 教程:http://www.wmpratt.com/swagger-and-asp-net-web-api-part-1/ 1:安装Dll: https://www.nuget.org/packages/Swashbuckle/ 2:配置Swagger GlobalConfiguration.Configuration .EnableSwagger(c => c.SingleApiVersion("v1", "A title

1.下载 nodejs,并安装 2. 下载swagger editor并安装 2.1 git clone https://github.com/swagger-api/swagger-editor.git //从github下载swagger-editor 2.2  cd swagger-editor //进入到下载的文件夹中 2.3 npm install 2.4 cd ..  //回退到上一曾目录 2.5 http-server swagger-editor  //启动swagger-edi

1.安装NuGet包 2.配置 3.运行测试 参考博客:https://www.cnblogs.com/yilezhu/p/9241261.html 一 安装NuGet包 包名:Swashbuckle.AspNetCore 二 配置 using System; using System.Collections.Generic; using System.IO; using System.Linq; using System.Threading.Tasks; using Microsoft.Asp

使用nuget控制台, 输入 Install-Package Swashbuckle,回车,等待安装引用.nuget国内没有镜像,安装比较慢 安装成功后会多出一个引用 右键工程点--属性,左边导航栏选择--生成,勾选--XML文档文件,XML名字可以起符合命名规范的任意值,Ctrl+S. 引用Swagger工具后App_Start底下会多出一个SwaggerConfig.cs,点击打开 修改如下: c.IncludeXmlComments(GetXmlCommentsPath()); priva

一.官方手册: https://www.kancloud.cn/manual/thinkphp5/118003 二.Git 方式安装[最新框架下载方式] 首先克隆下载应用项目仓库 git clone https://github.com/top-think/think tp5 然后切换到 tp5 目录下面下载核心框架 git clone https://github.com/top-think/framework thinkphp 两个仓库克隆完成后,就完成了ThinkPHP5.0的Git方式下

今天想在TP5上安装workerman,用于个人学习,然后悲剧的是,第一步就卡住了,根据手册里说的首先通过composer安装 composer require topthink/think-worker 结果报错了 composer require topthink/think-worker Using version ^2.0 for topthink/think-worker ./composer.json has been updated Loading composer reposit

一.环境要求 1.Nodejs ( 版本6.0x以上 ) 2.npm (npm 3.x) 注: linux 更新nodejs到最新 node -v 4.2.1 sudo npm cache clean -f sudo npm install -g n sudo n stable sudo ln -sf /usr/local/n/versions/node/<VERSION>/bin/node /usr/bin/nodejs node -v 8.2.1 二.启动 1.以http-server 启

今天把功能放到服务器,本地测试正常,上传到服务器上报错Class 'think\worker\Server' not found 首先想到的是Windows和Linux下大小写的问题,查看了代码,并没有出现这个问题 百度也没有查到是什么问题,后来在群里问,跟群里的大佬交流有了思路 错误原因:在本地composer安装了workerman,本地测试正常,放到服务器时只在IDE里上传了vendor里的topthink和workerman两个文件夹,原因可能是安装的时候会有其他的依赖什么的 解决方法:

Install-Package Swashbuckle -Pre 1.Startup // This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) { // Add framework services. services.AddMvc(); //*****

1,  建立或打开项目后,在“程序包管理器控制台”中执行以下命令添加包引用: Install-Package Swashbuckle.AspNetCore 2,在项目中打开Startup.cs文件,找到 Configure 方法,在其中添加如下代码: app.UseSwagger(); app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "MsSystem API V1")

查看内核版本 cat /proc/version cat /etc/redhat-release 查看系统是32位还是64位方法总结getconf LONG_BIT 安装相关工具 yum install curlyum install curl-develyum install zlib-develyum install openssl-develyum install perlyum install cpioyum install expat-develyum install gettext-

1.下载windows composer-setup.exe(我已下载一个Composer-Setup.exe); 2.我电脑使用的是phpstudy2018版 php-7.0.12-NTS 3.然后在命令行下面,切换到你的web根目录下面并执行下面的命令: 我的跟目录是D:\phpStudy\PHPTutorial\WWW 命令是: composer create-project topthink/think=5.0.* tpdong --prefer-dist 上面是官方的compose安装

这周因为公司的需求需要我做一个Api的程序,这周的三天时间我一直在Core Api和 framework Api之间做纠结.不知道要使用哪一个去做项目,想着想着就决定了.既然两个我都没用过那个何不来使用Core Api来做呢.也是对自己的一种锻炼! OK,接下来回归正题! Core下的Swagger和传统framework  Mvc下的Swagger是不一样的!  两者的差距:       其一:引用的程序集不一样.          其二:安装完程序集后需要配置的地方不一样,        

最近迷上了前后端分离的开发架构,工作中的项目几乎都采取这种模式,自己主要担任服务端RestFul风格的Webapi开发.那么问题来了,当前端开发人员找我要api说明文档的时候,曾一度非常可耻的冒出过word.excel之类的想法,oh my god!我一定是昨晚吃的东西还没消化,吃撑了.好了,言归正传,在团队开发中,一个好的 API 文档可以减少很多 交流成本 ,也可以使一个新人快速上手业务.so,swagger就是一个非常不错的选择,而且现在nuget中可以安装swagger的.net支撑包,

1.NuGet 下载安装 Swagger Install-Package Swashbuckle -Version 5.5.3 2.http://localhost:xxx/swagger 3. 4.修改 SwaggerConfig,定位 IncludeXmlComments c.IncludeXmlComments(string.Format("{0}/bin/App20161107.XML", System.AppDomain.CurrentDomain.BaseDirectory

WebApi写好之后,在线帮助文档以及能够在线调试的工具是专业化的表现,而Swagger毫无疑问是做Docs的最佳工具,自动生成每个Controller的接口说明,自动将参数解析成json,并且能够在线调试. 那么要讲Swagger应用到Asp.net Core中需要哪些步骤,填多少坑呢? 安装Swagger到项目 { "dependencies": { "Swashbuckle": "6.0.0-beta902", ........ 或者直接通