新增docs目录，内容是帮助文档

wangyan · Sep 22, 2012 · e1a0584 · e1a0584
1 parent dadfbf7
commit e1a0584
Show file tree

Hide file tree

Showing 7 changed files with 468 additions and 2 deletions.
diff --git a/Changelog b/Changelog
@@ -1,10 +1,13 @@
 一、当前版本
 
-version 0.2.9.22.70
-- 将所有相对路径改为绝对路径
+version 0.2.9.22.71
+- 新增docs目录，内容是帮助文档
 
 二、更新历史
 
+v0.2.9.22.70
+- 将所有相对路径改为绝对路径
+
 v0.2.9.22.69
 - 修复在特定情况下phpMyAdmin版本号记录出错
 

diff --git a/docs/about.md b/docs/about.md
@@ -0,0 +1,11 @@
+#Lanmp 项目相关信息
+## 一、项目成员
+### 介绍开发人员的相关情况
+## 二、贡献者
+### 所有为`LANMP`贡献过力量的人们
+## 三、项目地址
+###  如何使用`GIT`获取项目最新源代码
+## 四、讨论组
+### 在这里讨论项目相关问题
+## 五、邮件列表
+### 获取项目最新状况
diff --git a/docs/install.md b/docs/install.md
@@ -0,0 +1,124 @@
+## 一、系统需求
+
+* 需要`2GB`以上磁盘剩余空间
+* 需要`256M`以上内存空间
+* 服务器必须配置好软件源和可连接外网
+* 必须具有系统`Root`权限
+* 建议使用干净系统全新安装
+
+## 二、安装前准备
+
+1. 使用`putty`或`Bitvise Tunnelier`等`SSH`工具登陆
+
+    登陆后运行：`screen -S lanmp`
+
+    1）关于`screen`请自行`Google`，简单说该命令可以防止网络中断等因素造成的安装失败。  
+    2）如果提示`screen`命令不存在可以执行：`yum -y install screen` 安装。  
+
+2. 下载`LANMP`一键安装包
+
+    说明：稳定版是相对稳定的版本，开发版是更新频率较高的版本，带有新特性，但可能存在较多Bug。
+
+    方法一：直接下载已打包版本
+
+    1）下载稳定版：`wget -c http://wangyan.org/download/lanmp/lanmp-latest.tar.gz`  
+    2）或者下载开发版：`wget -c http://wangyan.org/download/lanmp/lanmp-dev-latest.tar.gz`  
+    2）开始安装：`cd lanmp && ./install.sh`  
+
+    方法二：通过Git下载（推荐）
+
+    1）安装`Git`软件：`yum -y install git`  
+    2）开始克隆：`git clone https://github.com/wangyan/lanmp.git`  
+    3）安装稳定版： `cd lanmp && ./install.sh`  
+    4）或者安装开发版： `cd lanmp && git checkout develop && ./install.sh`  
+
+## 三、安装步骤
+
+1. 输入服务器公网IP地址(IPv4)
+
+    脚本默认会自动获取IP地址，如果发现不准确，请手工输入。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-1.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-1.jpg" width="450" /></a>
+
+2. 输入默认网站目录
+
+    默认网站路径是 `/var/www`，虚拟主机数据目录是 `/home`，所以此项一般保持默认不要改动。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-2.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-2.jpg" width="450" /></a>
+
+3. 输入`MySQL`数据库`Root`用户密码
+
+    `MySQL`数据库`Root`最高权限用户密码，为安全起见，请尽可能使用复杂密码。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-3.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-3.jpg" width="450" /></a>
+
+4. 输入`MySQL`数据库`PMA`用户密码
+
+    `PMA`用户是为了让phpMyAdmin支持额外的链接表特性，该密码仅在安装时使用一次，因此你可以使用随机密码。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-4.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-4.jpg" width="450" /></a>
+
+5. 请选择服务器架构 （重要）
+
+    1）单独 `Nginx`（`lnmp`）：效率高，但不兼容`Apache`的`Rewrite`规则，低内存微型用户首选。    
+    2）单独 `Apache` (`lamp`)：经典组合，兼容性好，几乎所有程序都支持。    
+    3）`Apache` + `Nginx (`lanmp`)：`Nginx`作为前端处理静态文件，`Php`脚本转后端`Apache`处理，该架构可发挥`Nginx`处理静态文件优势，还可以作负载均衡，个人推荐。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-5.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-5.jpg" width="450" /></a>
+
+6. 选择安装的`PHP`版本
+
+    默认是`PHP 5.4`系列，但有些程序需要旧版Zend支持如`ShopEX`，所以也可以安装旧版`PHP 5.2`系列
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-6.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-6.jpg" width="450" /></a>
+
+7. 是否要初始化阿里云服务器（选做）
+
+    1）程序会自动判断你是否使用的是阿里云服务器，非阿里云用户不会出现该选项。  
+    2）如果选择是(y)，那么程序会格式化数据盘，并挂载到/home目录。（适用于初次安装或重装系统后的用户）  
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-7.png"><img src="http://wangyan.org/pic/l/lanmp-setup-7.png" width="450" /></a>
+
+8. 选择是否安装的`xCache`加速器
+
+    可大幅提高PHP性能，不需要犹豫，立即安装吧！这货甚至比`eaccelerator`还牛逼。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-8.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-8.jpg" width="450" /></a>
+
+9. 选择是否安装的`ioncube`
+
+    PHP解密工具，类似于`Zend Optimizer`，如果你不玩`WHMCS`，可以不装。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-9.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-9.jpg" width="450" /></a>
+
+10. 选择是否安装的`Zend Optimizer`
+
+    如果您用的是开源程序，则可以不装。    
+    注意：如果您上面选择安装的PHP版本是5.2，那么这里自动安装`Zend Optimizer`，否则自动安装`Zend GuardLoader`
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-10.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-10.jpg" width="450" /></a>
+
+11. 最后一步，按任意键开始安装。
+
+    注意：任意键可不包括主机电源键。。。 
+    按 `<Ctrl> + c` 可放弃安装。
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-11.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-11.jpg" width="450" /></a>
+
+## 四、结束
+
+* 安装结束后，可看到下图，意思很明确了，请谨记该图中的帐号信息。    
+* 在浏览器中打开图中所示的PHP探针地址，如：`http://192.168.8.134/p.php`，即可看到整个安装过程是否成功。
+* 部分VPS装有`iptables`防火墙，请使用下面命令关闭。`service iptables stop && chkconfig iptables off`
+* 安装失败的，请按下面提示进行反馈，谢谢！
+
+    <a href="http://wangyan.org/pic/l/lanmp-setup-12.jpg"><img src="http://wangyan.org/pic/l/lanmp-setup-12.jpg" width="450" /></a>
+
+## 五、反馈
+
+如果安装失败，请您将安装目录下的`log.txt`日志文件发给我分析。    
+或者通过下面方式与我联系，谢谢！
+
+> Email: [WangYan@188.com](WangYan@188.com)    
+> Twitter：[@wang_yan](https://twitter.com/wang_yan)    
+> Home Page: [WangYan Blog](http://wangyan.org/blog)    
diff --git a/docs/introduction.md b/docs/introduction.md
@@ -0,0 +1,62 @@
+#LANMP 一键安装包简介
+
+## 一、简介
+
+1.	`LANMP` 指的是 `Linux` + `Apache` + `Nginx` + `MySQL` + `PHP` 运行环境。
+2.	`LANMP` 一键安装包是用 `Linux Shell` 语言编写的，用于在 `Linux` 系统(`Redhat`/`CentOS`/`Debian`/`Ubuntu`)上一键安装 `LANMP`环境的工具包。
+
+## 二、特点与优势
+1.	3种Web环境自由组合
+
+	`lnmp`、`lamp`、`lanmp`（Nginx前端Apache后端）可自主选择，甚至安装完后还可以自由调整。
+
+2.	最新版本软件包
+
+	全部采用最新稳定版本的软件包，如`PHP 5.4`（可选择`PHP 5.2`）系列，`MySQL 5.5`系列。
+
+3.	下载更智能更方便
+
+	自动从官方地址下载最新稳定版本源码安装，如果官网挂了或被和谐了，可自动从备选地址下载最新版。
+
+4.	完美多用户支持
+
+	配套了虚拟主机用户添加和删除脚本，因此可用来做虚拟主机销售。（主网站位于`/var/www`目录，用户网站位于`/home/user1`、`/home/user2`...）
+
+5.	完善的扩展支持
+
+	除小型依赖库外，都尽可能从源码编译安装。如PHP支持了`gd`,`memcache`,`xcache`,`pdo mysql`等扩展。
+
+6.	多种PHP处理方式
+
+	`Nginx`以`FastCGI`方式解析`PHP`，`Nginx`+`Apache`可选以`php moudle`或`FastCGI`方式方式解析`PHP`。
+
+7.	模块化安装流程
+
+	模块化、清晰的安装流程，脚本非常易于理解，因此您可以很容易修改脚本。
+
+8.	简洁与高效
+
+	只安装必须的东西，没有臃肿的图形界面。
+
+9.	支持自动升级
+
+	安装前可自动安装最新版本，安装后也可升级到最新版本。
+
+10.	其他
+
+	如`phpMyAdmin`支持额外的链接表特性，支持添加二级子域名，自定义`Rewrite`规则等等。
+
+## 三、配置文件位置
+
++	`php:	/usr/local/php/lib/php.ini`
++	`php-fpm:	/usr/local/php/etc/php-fpm.conf`
++	`pear:	/usr/local/php/etc/pear.conf`
++	`nginx:	/usr/local/nginx/conf/nginx.conf`
++	`httpd:	/usr/local/apache/conf/httpd.conf`
++	`mysql:	/etc/my.cnf`
++	......
+
+## 四、注意事项
+
+1.	LANMP一键安装包针对了512M内存的VPS进行了些优化。如果你的内存较低，建议您要修改php或apache的配置文件。
+2.	下载版安装包需要连接互联网，完整版安装包可以在局域安装，但需要配置好局域网的更新源。
diff --git a/docs/upgrade.md b/docs/upgrade.md
@@ -0,0 +1,55 @@
+#Lanmp 组件升级说明
+
+## 一、概述
+
+* Lanmp 现已支持自动升级，程序会查找当前版本和最新版本，并提示你是否升级。  
+* 升级有风险，请务必做好所有数据备份，注意是所有重要数据，包括mysql数据。  
+
+## 二、升级步骤
+
+1. 输入默认网站目录
+
+    这里要输入您当时选择的目录，如果您当时没有修改，则保持默认网站路径 `/var/www`。  
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-1.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-1.png" width="450" /></a>  
+
+2. 请选择服务器架构
+
+    这里不能乱填，如果您安装时是选择`3`，那么这里也要选择`3`  
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-2.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-2.png" width="450" /></a>  
+
+3. 询问是否需要升级PHP
+
+    如下图，程序已成功获取已安装PHP版本是`5.2.17p1`，最新PHP版本是`5.4.7`，于是询问你是否需要升级。  
+
+    请注意：目前不支持从PHP 5.2系列跳跃升级到5.4系列。（下图仅作为演示）  
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-3.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-3.png" width="450" /></a>  
+
+4. 询问是否需要升级xCache组件
+
+   一般默认升级，xCache可是个好东西。 ^_^
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-4.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-4.png" width="450" /></a>  
+
+5. 询问是否需要升级Nginx
+
+    如下图，程序已成功获取已安装Nginx版本是`1.3.5`，最新Nginx版本是`1.3.6`，于是询问你是否需要升级。  
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-5.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-5.png" width="450" /></a>  
+
+6. 询问是否需要升级phpMyAdmin
+
+    如下图，程序已成功获取已安装phpMyAdmin版本是`3.5.2.1`，最新phpMyAdmin版本是`3.5.2.2`，于是询问你是否需要升级。  
+
+    <a href="http://wangyan.org/pic/l/lanmp-upgrade-6.png"><img src="http://wangyan.org/pic/l/lanmp-upgrade-6.png" width="450" /></a>  
+
+## 三、反馈
+
+如果您升级失败，请您运行`nginx -t`和`apache -t`命令，查找原因。    
+或者通过下面方式与我联系，谢谢！
+
+> Email: [WangYan@188.com](WangYan@188.com)    
+> Twitter：[@wang_yan](https://twitter.com/wang_yan)    
+> Home Page: [WangYan Blog](http://wangyan.org/blog)