淘宝开放平台 SDK使用说明文档
我的图书馆
淘宝开放平台 SDK使用说明文档
SDK使用说明文档
更新时间 .&
一、SDK下载介绍
淘宝开放平台的SDK是由程序自动化生成的代码包，其中包含了已经开放的API和相应的请求、加密、返回解析等一些必要的功能。
支持的开发环境：
java&sdk支持1.5及以上（目前仅支持j2se标准java平台使用，不适合andriod平台）；
.net&sdk支持.net&2.0及以上；
php&sdk支持php5及以上；
python sdk支持python2.7及以上
ios sdk支持ios 4以上的操作系统
1、下载说明
SDK（开发工具包）是根据每个应用的API调用权限进行单独打包的，需要您登录到“开发者中心”通过应用的管理页面进行下载。
因此，首先您必须：
1、注册成为淘宝开放平台的开发者；
2、选择一款您需要的应用标签创建一款应用；
2、下载SDK
1）标准版sdk（包含java，.net，php，python四个版本下载）
下载地址：
更新记录：
2）ios sdk
下载地址：
& & & &当前版本：
<font style="font-size:10" color="#130424
& & & &修改内容：支持crash日志收集，修复数据交互BUG。
更新记录：
3）android sdk
下载地址：
&当前版本：1.0.1
& & & &修改内容：修复TQL串行化批量操作模式下返回结果解析错误，同时TQL回调Listener类型重新定义。
& & & & & & & & & & & &修复未授权情况下调用不需要授权的TQL时出现的空指针。
更新记录：
4）TopClient sdk(客户端应用)
下载地址：
&当前版本：1.0
5）权限包对应的sdk下载方式
注册并创建应用成功后，直接访问，然后点击对应的应用，可以通过以下两种方式查看到下载入口：
注：sdk是每天13:00和17:00两个时间段做定时更新的，如果isv的权限包有变动，建议在这两个时间段后下载最新的sdk
第一步：通过【应用列表】，点击APPKEY:XXXX的链接；
第二步：查看应用详情页面，通过左侧【基本信息】的入口点击进入；
下载入口（如下图），点击【SDK下载】即会弹出下载页面。
注：sdk下载页面提供了标准版和您的权限对应的sdk下载
3、SDK更新记录
4、API历史变更
5、其他说明
如何注册成为“开发者”并创建一款应用：
http://open.taobao.com/doc/detail.htm?id=66
注册成为开发者的条件：
http://open.taobao.com/doc/detail.htm?id=36
应用标签规则：
http://open.taobao.com/doc/detail.htm?id=136
应用接入的规则：
http://open.taobao.com/doc/detail.htm?id=42
二、Android SDK使用说明
1、创建APPKEY
创建一个新的应用，参考文档：
& & 1）如果此无线应用针对买家需求开发上图的应用标签请选择“无线买家应用”。
& & 2）如果是针对卖家需求开发请选择“在线订购应用”，发布服务时类目选择“无线专区”。
创建完应用后需要在应用详情页面设置应用属性，这里需要提及的是【应用设置-基本信息】页面的“架构类型”以及“回调URL”的配置，参考下图进行配置：
这个很重要，这个会影响到用户授权后浏览器对APP的回调。建议使用应用的包名作为scheme，这样可以尽量保证scheme的唯一性。
并且【回调URL】、【Androidmanifest.xml】、【TopAndroidClient.registerAndroidClient】三处的scheme保持一致（且不能使用http），比如以下demo都使用了“callback://”
2、准备开发环境
1）安装JDK (1.6及以上版本)
2）安装Eclipse
3）检查Eclipse的编译级别，请选择1.6
4）安装Android SDK及Eclipse插件。具体参考：http://developer.android.com/sdk/installing/index.html
5）TOP Android SDK需要Android 2.1支持，请先使用Android SDK Manager进行下载。
缺少Android 2.1时TOP Android SDK导入Eclilpse后会出现红叉。
6）下载TOP Android SDK&
3、准备编码
&1）创建Android工程
&将TOP Android SDK导入Eclipse。导入之前请不要把TOP Android SDK代码放在Eclipse workspace目录下。
Eclipse-&File-&Import，如下图：
选择SDK下载路径，导入SDK到Eclipse，如下图：
将工程代码文件编码设为UTF-8。（Project-&Properties-&Resource）
创建一个新的Android工程，添加对TOP Android SDK的引用。
Project-&Properties-&Android-&Library，如下图：
& 2）注册APK签名
出于安全考虑开放平台要求你在“开发者中心”注册你的应用的签名。可以在SDK下载包里找到获取签名的工具：apk-parser。
cd到apk-parser文件下，然后执行parse.bat或parse.sh。后面添加APK文件路径（APK文件是你自己打包的文件。如果是官方提供的Sample，可以用bin目录下系统自动生成的APK文件），例如下图：
在“Android应用认证”页面将上面工具中得到签名填入文本框中。
注意，以下情况需要重新对APK进行签名并注册到“开发者中心”：
& & 1.当你的应用正式发布的时候，一般都会重新用RSA私钥对APK进行签名
& & 2.重新打包生成APK文件
& & 3.更换appkey
4、开始开发
& 1）启用App Key
TopAndroidClient是使用TOP Android SDK的入口，在前面申请得到的App Key需要注册到此类中才能进行后续的授权及API调用操作。
PS: TopAndroidClient支持同时注册多个App Key。
获得TopAndroidClient实例：
&2）用户授权
出于安全考虑第三方应用进行用户授权操作时必须在浏览器上进行。只需要调用以下代码即可实现：
TopAndroidClient对象需要传入一个Activity实例来完成对浏览器的启动。
无论用户授权成功或者失败浏览器都会回调你的应用。为了接收回调的数据请按以下步骤进行操作：
继承com.taobao.top.android.auth.AuthActivity实现一个Activity完成授权以后的后续操作。这个子类需要实现两个方法，这两个方法的作用请见方法注释和原代码。
在 AndroidManifest.xml中配置这个Activity
另外需要申请以下三个权限
& 3）调用API
调用REST API
示例代码：
注意：在Android3.0以后对于在UI主线程中同步访问网络默认情况下会导致访问失败。所以请慎用同步方式调用API
附件上传示例代码：
示例代码：
Refresh Token
关于何时进行刷新？使用TOP Android SDK进行开发的应用安全等级为2级，R2级别的授权时长为3天，并且可以通过刷新的方式延长R2的授权时长。具体请参考安全等级说明文档：http://open.taobao.com/doc/detail.htm?id=1002
每次授权或者Refresh Token完成时通过AuthorizeListener都可以获得AccessToken对象，通过此对象的getStartDate()方法可以获得这个token的失效计时的开始时间点。这个时间点是取自淘宝系统时间因为网络传输的问题会有一些时间差。
通过下面的方式可以得到某个级别授权的过期时间点。
大家在过期时间到来之前提前进行刷新操作。采用异步方式刷新Token。
5、Sample使用说明
下载包解压后TopAndroidSample目录下是使用样例。将此工程代码导入Eclipse之后请添加对TOP Android SDK的依赖。
请修改SampleApplication类中注册App Key的相关代码，请填入你自己的APP相关信息。MainActivity获得TopAndroidClient实例的代码中请填入你的App Key。
使用demo前记得注册APK签名哦！！！
在测试demo上的功能前请先做一次授权。Android 3.0以上测试同步调用会失败，失败原因前面已经描述过。
Android平台支持
&SDK依赖Android系统版本
&ARM, ARM-NEON & & & & & & & & &
&Android 2.1 (API Level 7) and higher
&Android 2.3 (API Level 9) and higher
&Android 2.3 (API Level 9) and higher &
有问题可以到开放平台支持中心提问：http://open.taobao.com/support/index.htm
三、iOS SDK使用说明
无线开发者在淘宝应用市场越来越多，而开发过程中往往会遇到很多授权及服务调用通信方面的问题，因此淘宝开放平台提供了IOS SDK来帮助开发者快速开发业务（无需关注授权，服务多线程调用，异步处理返回等问题）。同时由于无线端的安全问题比较突出，开放平台通过SDK配合服务端升级了授权和通信交互协议，提高了无线应用使用卖家相关的服务权限，便于无线开发者深度开发无线卖家应用。
&当前开放平台上无线类应用分成两类：无线买家应用，在线订购应用（无线应用类目），后者主要是无线卖家类应用。两类应用的差别是服务使用权限不同，后者更偏向于卖家服务类应用的开发。
2、创建APPKEY
创建一个新的应用，参考文档：
& & 1）如果此无线应用针对买家需求开发上图的应用标签请选择“无线买家应用”。
& & 2）如果是针对卖家需求开发请选择“在线订购应用”，发布服务时类目选择“无线专区”。
创建完应用后需要在应用详情页面设置应用属性，这里需要提及的是【应用设置-基本信息】页面的“架构类型”以及“回调URL”的配置，参考下图进行配置：
这个很重要，这个会影响到用户授权后浏览器对APP的回调。建议使用应用的包名作为scheme，这样可以尽量保证scheme的唯一性。
并且确保【回调URL】、【target-info-url Type】、【TopIOSClient registerIOSClient】三处的scheme保持一致（且不能使用http），比如以下demo都采用“callback://”
3、使用IOS sdk
当前TOP IOS sdk提供的是静态链接库的方式给外部开发者，提供的是一系列接口（几个h结尾的文件）和两个链接库文件（.a结尾的文件，其中名字较长的是用于模拟器开发使用）。使用静态链接库的方式，打开应用，右键选择add Files to …，将模拟器静态文件和接口文件加入到项目中，如下图（结构可以调整的更好一些）
&&&&&& 接着大家就可以使用这个静态链接库了。
4、跑通demo
& 1）APPKEY以及URL Scheme的配置
很多时候跑起来HelloWorld，就能够给大家减少非常多的问题。因此这里将会通过一个应用的构建和运行来让开发者对无线SDK的集成有一个大致的概念。因此在整个压缩包里面还包含了一个sdk的demo项目，这个项目只需要少量修改就可以运行起来。
首先选择TopAppDelegate.m这个文件，里面有如下两个方法：
//这个方法是在应用启动的时候，初始化你的ios sdk（注册了一个appkey的Ios client实例，只要调用过registerIOSClient，后面就可以通过getIOSClientByAppkey来获得实例授权和调用服务），需要做的就是修改蓝色部分的内容。appkey换成你刚才申请的应用的appkey，appsecretcode替换成这个appkey对应的secretcode，callbackurl请非常小心的修改为你自己定义的一个native地址（暂时你可以不修改，但是你需要去修改app的信息中回调地址url也为appcallback://），注意这个native必须和刚才前面提到的应用回调页面url设置完全保持一致（什么叫native地址，就是应用的外部交互地址，比如你设置appcallback://作为你的交互地址，那么如果你在safari浏览器里面输入appcallback://name=cenwenchu&age=33，此时应用就会和一台服务器一样接收到请求和参数，那应用什么地方会处理这个请求呢，就请看下面一个函数）
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
&&& [TopIOSClient registerIOSClient:@"appkey" appSecret:@"appsecretcode" callbackUrl:@"appcallback://" needAutoRefreshToken:TRUE];
&&& return YES;
//这个函数是应用处理外部请求的函数，url就是外部的url信息，这里注意，因为当前外部请求默认都是授权处理，因此下面代码中就是对授权的处理，第一句话就是获取某一个appkey对应的IOS sdk实例（这个客户端支持多个appkey实例），因此修改那个蓝色的appkey为你的真实appkey。下面一句话不用修改，默认处理授权url返回。
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL*)url
&&& TopIOSClient *iosClient = [TopIOSClient getIOSClientByAppKey:@"appkey"];
&&& [iosClient authCallback:url];
&&& return YES;
接着，就要设置native地址如何被识别的关键步骤，选择sdk项目本身，然后选择target，再选择info这个tab，就可以看到下图
选择URL types，然后再选择右下角的＋，填入刚才我们的地址协议部分：appcallback，然后保存。至此如果你修改完open.taobao.com中的应用回调地址后，授权设置就完毕了。（总结一下，注册appclient的时候的回调地址和app再open.taobao.com保持一致，然后将协议部分设置到应用的url types）
注意：当步骤一创建appkey的时候回调地址填写的是callback://，那么这里的url scheme设置为callback。两者切记保持一致。
&然后开始修改业务逻辑代码比较重的TopViewController.m文件，这个文件主要负责响应前台界面指令，做以下几件事情：发起授权，调用普通API，调用TQL，调用图片上传类的服务。下面按照这个顺序去介绍：
(这个方法只需要替换掉appkey为正式的appkey即可)
- (IBAction)authAction:(id)sender {
&&& TopIOSClient *iosClient = [TopIOSClient getIOSClientByAppKey:@"appkey"];
&&& [iosClient auth:self cb:@selector(authCallback:)];
&上面这个函数响应授权按钮发起的指令，首先还是通过标准的方式获取客户端，注意将appkey替换成你前面合法设置的appkey，然后调用授权（iosclient的auth方法），方法有两个参数，self作为第一个参数，@selector(authcallback：)作为第二个参数，其实就是授权成功或者失败的回调函数，这里是通过SEL的方式来回调，因此需要给出归属对象和对象的方法，这里给的是当前TopViewController这个对象（self关键字来替代），方法就是TopViewController中的authCallback这个方法，可以搜索这个类看到具体的代码。（授权方法详细描述参考api接口文件中的注释）
& 3）API调用
(这个方法只需要替换掉appkey为正式的appkey即可)
- (IBAction)sendRequestAction:(id)sender {
&&& //……(前面都是准备参数的代码)
& & &TopIOSClient *iosClient =[TopIOSClient getIOSClientByAppKey:@"appkey"];
& & &[iosClient api:@"GET" params:params target:self cb:@selector(showApiResponse:) userId:uid needMainThreadCallBack:true];
&&&&&&&& ……
api的调用方式很简单，获取出appkey对应的client实例，然后调用它的api方法，第一个参数是http请求方式（淘宝开放平台对与更新操作要求必须用post方式），第二个参数是业务参数集合，第三，第四个参数是服务返回后回调应用处理的函数，第五个参数表明是对那一个用户做服务调用（因为api调用过程中如果操作用户数据必须有授权，当你授权完成以后，sdk内部会保存授权信息，此时你只需要通过传入用户id，sdk就会在请求的时候带上用户的授权调用服务），最后一个参数用来告诉sdk是否要用主线程阻塞模式回调，因为部分情况下返回结果直接要渲染到view上，那么必须通过主线程阻塞模式来做，如果不是渲染view，可以选择非主线程模式。至此看以下这个类的showApiResponse你就能只到返回怎么处理了，接口细节参看api接口文件中的注释。
& 4）TQL调用
TQL是另一种方式的服务调用，可以支持服务并联和串联调用，具体参看：&,调用方式和普通api调用非常类似，唯一的差异是它调用的是client的tql方法，前者是api方法。
下面代码主要用了同步调用模式，注释掉的是异步模式，异步模式和上面的普通调用一样，开发者根据自己需求来选择异步还是同步模式。
- (IBAction)tqlRequest:(id)sender {
&&& TopIOSClient *iosClient = [TopIOSClient getIOSClientByAppKey:@"appkey"];
&&& NSMutableDictionary *params = [[NSMutableDictionary alloc] init];
&&& NSString *uid = [userId text];
&&& [params setValue:@"select uid,nick,sex from user" forKey:@"ql"];
&&& //[params setValue:@"select num_iid,title,nick,pic_url,cid,price,type,delist_time,post_fee from item where num_iid=" forKey:@"ql"];
&&& //[iosClient tql:@"GET" params:params target:self cb:@selector(showApiResponse:) userId:uid needMainThreadCallBack:true];
&&& TopApiResponse * response = [iosClient tql:@"GET" params:params userId:uid];
&&& [responseContentView setText:[response content]];
& 5）Schedule调用
Schedule提供的是一种异步定时任务服务，具体使用场景和使用方法参看：&，当前SDK只提供同步接口（因为Schedule本身就是异步，因此无需提供异步模式）
- (IBAction)scheduleRequest:(id)sender {
& & &TopIOSClient *iosClient = [TopIOSClient getIOSClientByAppKey:@"appkey"];
& & &NSMutableDictionary *params = [[NSMutableDictionary alloc] init];
& & &NSString *uid = [userId text];
& & &[params setValue:@"select num_iid,title,nick,pic_url,cid,price,type,delist_time,post_fee from item where num_iid=" forKey:@"ql"];
& & &[params setValue:@" 13:00:20" forKey:@"schedule"];
& & &[params setValue:@"http://10.13.201.118:7777" forKey:@"callbackurl"];
& & &response = [iosClient schedule:@"GET" params:params userId:uid];
& & &if ([response error])
& & & & & & &NSLog(@"schedule api call result : %@",[response error]);
& & & & & & &NSLog(@"schedule api call result : %@",[response content]);
& 6）图片上传类服务
这类服务就是一种api的调用服务，只是因为内部包含了图片等二进制内容，需要采用multipart方式发起请求。这里要求将图片之类的二进制文件封装到一个TopAttachment的类中，然后作为参数放入params里面发起请求。其他没有什么差别，注意将appkey替换成自己的appkey。
注意如果是文件类型必须初始化为Attachment放入params，这样sdk可以自动识别，如果是图片注意他的名字后缀需要符合规范，gif,jpg,jpeg,png,bmp，具体参见文档。
- (IBAction)uploadPicAction:(id)sender {
&&& NSString *uid = [userId text];
&&& NSMutableDictionary *params = [[NSMutableDictionary alloc]init];
&&& [params setObject:@"taobao.item.img.upload" forKey:@"method"];
&&& [params setObject:@"" forKey:@"num_iid"];
&&& NSURL *url = [[NSURL alloc] initWithString:@"http://upload.wikimedia.org/wikipedia/commons/d/de/POL_apple.jpg"];
&&& NSData *image_data = [NSData dataWithContentsOfURL:url];
&&& TopAttachment *image = [[TopAttachment alloc]init];
&&& [image setData:image_data];
&&& [image setName:@"apple.jpg"];
&&& [params setObject:image forKey:@"image"];
&&& TopIOSClient *iosClient =[TopIOSClient getIOSClientByAppKey:@"appkey"];
&&& [iosClient api:@"POST" params:params target:self cb:@selector(showApiResponse:) userId:uid needMainThreadCallBack:true];
至此，如果你确认修改完了所有appkey和上文说道的地方，然后将静态类库（模拟器版本）和接口引入到项目，你就可以点击运行了。
首先你可以点击授权那个按钮，会弹出浏览器，然后授权，请填入自己的淘宝id（注意，如果你是买家类应用没有上线的时候会默认绑定你app注册时候的淘宝帐号作为测试帐号，其他帐号不能使用，如果要增加更多帐号测试，去应用页面选择管理授权，就可以增加了），然后授权成功会返回到上一个页面。（此时授权已经保存在客户端内部了，会帮持久化到客户端中，同时如果在创建应用客户端实例的时候可以设置是否自动刷新授权），此时你可一看到user_id已经有内容了，是你授权的用户的user_id。（不要修改，后续请求时候要用）
这个时候就可以点击tql，发送请求，上传图片（这个代码需要修改以下，可以自己去发一个二手商品，然后修改商品图片，因为测试代码中是我的一个商品，可能无法操作）。
最后如果遇到任何服务端的错误，可以直接到支持中心搜索：&很多问题就可以被得到解答。
常见问题以及解决方法
网站合作 xtao#taobao.com
其他咨询 top#taobao.com
友情链接：
Copyright ?
Taobao.com 版权所有
馆藏&25226
TA的最新馆藏
喜欢该文的人也喜欢由于开发EduSoho需要有一些基础技术能力，为帮助广大开发者简单、便捷、快速开发应用，云平台为开发者提供一系列视频开发教程,视频教程对应用的开发指南进行了详细说明，供开发者参考使用。
注：开发的应用只能在EduSoho产品中运行。
1.代码下载
Git下载:git clone https://github.com/EduSoho/EduSoho.git
SVN下载:svn co https://github.com/EduSoho/EduSoho
2.开发环境
官方推荐的配置是LNMP,即Linux+Nginx+MySQL+PHP。Windows用户请参考相关文档 Windows一键安装包.
在支持论坛上，有各种环境安装的帖子：
操作系统：Linux
推荐使用Ubuntu，CentOS
Web服务器：推荐Nginx或Apache2
MYSQL数据库：推荐5.5及以上版本
PHP版本：推荐5.3.17以上
开发工具：推荐Sublime Text2
3.主要文件目录结构说明
App应用程序核心目录
App/cache缓存目录
App/DoctrineMigrations数据库更新脚本目录
App/config配置文件目录
App/data该目录下存放的是私有的文件课时的视频、音频等
App/logs程序日志
doc文档目录，包含apache和nginx的配置文件
plugins插件目录
src源代码目录
Src/Topxia/WebBundle前台界面代码目录
Src/Topxia/AdminBundle管理后台界面代码目录
Src/Topxia/Service核心业务代码目录
Src/Topxia/DataTag模板标签目录
Src/Topxia/Common程序通用类目录
Vendor程序依赖的第三方库
Vendor_user程序依赖的第三方应用中心类库
webweb资源根目录
Web/app_dev.php开发环镜下程序主入口文件
Web/bundles程序前后台资源文件
Web/themes程序主题目录
4.系统主要业务逻辑模块说明
模块文件地址说明
Src/Topxia/Service/Course/CourseService课程核心服务
Src/Topxia/Service/Course/MaterialService课程资料服务
Src/Topxia/Service/Course/NoteService课程笔记服务
Src/Topxia/Service/Course/ReviewService课程评价
Src/Topxia/Service/Course/ThreadService课程讨论区服务，含话题及问答
Src/Topxia/Service/User/UserService用户服务
Src/Topxia/Service/User/MessageService私信服务
Src/Topxia/Service/User/NotificationService系统通知服务
Src/Topxia/Service/Taxonomy/CategoryService分类服务
Src/Topxia/Service/Taxonomy/TagService标签服务
Src/Topxia/Service/System/LogService日志服务
Src/Topxia/Service/System/SettingService系统设置服务
Src/Topxia/Service/Testpaper/TestpaperService题库服务
5.安装第三方组件
EduSoho采用Composer来管理第三方组件的依赖关系，只需在项目中声明所依赖的外部工具库(libraries)，Composer会帮你安装这些依赖的库文件。关于Composer的使用请
Composer下载：
1.使用curl下载：
curl -sS https://getcomposer.org/installer | php
如果你没有安装curl，你可以使用php下载
2.php下载：
php -r "readfile('https://getcomposer.org/installer');" | php
安装步骤：
php composer.phar install
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
- Installing doctrine/lexer (v1.0)
Loading from cache
- Installing doctrine/annotations (v1.2.0)
Loading from cache
- Installing doctrine/cache (v1.3.0)
Loading from cache
- Installing doctrine/collections (v1.2)
Loading from cache
- Installing twig/twig (v1.16.0)
Loading from cache
- Installing symfony/symfony (v2.3.18)
Loading from cache
Generating autoload files
Creating the "app/config/parameters.yml" file
Some parameters are missing. Please provide them.
database_driver (pdo_mysql):
database_host (127.0.0.1):
database_port (null):
database_name (symfony): edusoho-test
database_user (root):
database_password (null): root
mailer_transport (smtp):
mailer_host (127.0.0.1):
mailer_user (null):
mailer_password (null):
locale (en):
secret (ThisTokenIsNotSoSecretChangeIt):
由于本地曾经下过第三方组件，所以下载时都是从缓存中取的；至此第三方组件安装与数据库配置完成。
关于Nginx：
下载地址： http://nginx.org/en/download.html
版本推荐： 1.0以上
首先需要设置Nginx上传文件的大小限制：
修改nginx.conf文件： 找到”sendfile on"上方插入一行"client_max_body_size 200m;"。
EduSoho的Nginx虚拟主机配置文件 (更多内容详见软件包中的doc/nginx_server_config.txt文件)：
listen 80;
# [改] 网站的域名
server_name edusoho-dev.com www.edusoho-dev.
# [改] 程序的安装路径
root /var/www/edusoho/
# [改] 日志路径
access_log /var/log/nginx/example.com.access.
error_log /var/log/nginx/example.com.error.
location / {
index app.
try_files $uri @
location @rewriteapp {
rewrite ^(.*)$ /app.php/$1
location ~ ^/udisk {
# [改] 请根据程序的实际安装路径修改。该目录下存放的是私有的文件课时的视频、音频等。
root /var/www/edusoho/app/data/;
location ~ ^/(app|app_dev)\.php(/|$) {
# [改] 请根据实际php-fpm运行的方式修改
fastcgi_pass
unix:/var/run/php5-fpm.
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_
fastcgi_param
SCRIPT_FILENAME
$document_root$fastcgi_script_
fastcgi_param
fastcgi_param HTTP_X-Sendfile-Type X-Accel-R
# [改] 请根据程序的实际安装路径修改。该目录下存放的是私有的文件。
fastcgi_param HTTP_X-Accel-Mapping /udisk=/var/www/edusoho/app/data/
fastcgi_buffer_size 128k;
fastcgi_buffers 8 128k;
# 配置设置图片格式文件
location ~* \.(jpg|jpeg|gif|png|ico|swf)$ {
# 过期时间为3年
expires 3y;
# 关闭日志记录
# 关闭gzip压缩，减少CPU消耗，因为图片的压缩率不高。
# 配置css/js文件
location ~* \.(css|js)$ {
expires 3y;
# 禁止用户上传目录下所有.php文件的访问，提高安全性
location ~ ^/files/.*\.(php|php5)$ {
# 以下配置允许运行.php的程序，方便于其他第三方系统的集成。
location ~ \.php$ {
# [改] 请根据实际php-fpm运行的方式修改
fastcgi_pass
unix:/var/run/php5-fpm.
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_
fastcgi_param
SCRIPT_FILENAME
$document_root$fastcgi_script_
fastcgi_param
配置完成之后重新加载nginx
php nginx -s reload
关于Apache2：
下载地址： http://httpd.apache.org/download.cgi
推荐版本： 2.0以上
EduSoho的Apache2 虚拟主机配置文件 (更多内容详见软件包中的doc/apache_server_config.txt文件)：
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/edusoho/web
LoadModule xsendfile_module modules/mod_xsendfile.so
XSendFile On
XSendFilePath /var/www/edusoho/web/files/
&Directory /var/www/edusoho/web/&
# enable the .htaccess rewrites
AllowOverride All
Order allow,deny
Allow from All
&/Directory&
ErrorLog /var/log/apache2/example.com_error.log
CustomLog /var/log/apache2/example.com_access.log combined
修改hosts ，以配置的相同的域名访问
sudo vim /etc/hosts
#在hosts文件中加入server_name,与nginx_server_config.txt中的server_name或与apache_server_config.txt中的ServerName相同
edusoho-dev.com www.edusoho-dev.com
mysql -u root -p
create database edusoho-test
创建插件配置文件app/config/routing_plugins.yml，内容可以为空。
初始化表结构与数据
app/console doctrine:migrations:migrate
app/console topxia:init
打开浏览器访问www.edusoho-dev.com,如页面能正常打开说明您在开发前的准备工作已经完成。