Pagekit 中文文档（一）快速开始 - pagekit吧

level 8

PC丶爱好者楼主

# 快速开始
此篇文档将会带领你浏览 Pagekit 的完整安装过程。
下载 Pagekit：http://www.pagekit.com
## 运行环境
确定你的服务器满足以下必备条件：
- Apache 2.2+
- MySQL Server 5.1+
- PHP Version 5.4.0+
除此之外, Pagekit 还需要某些 PHP 拓展(extensions)的支持。你可以从这里获得完整的 [服务器需求部分](troubleshooting.md).
## 安装
首先，解压已下载的 Pagekit 压缩包并将内容复制到需使用的网站服务器目录下。
### 1. 设置权限
在开始安装之前，请确保刚刚上传的文件夹已经按照要求设置好
正确的
权限。我们推荐将其设置为 *755*。 Pagekit 需要以下的文件和目录保持可写状态:
| 文件 / 文件夹 | 描述 |
|------------------|-------------|
| `/app` | 存储临时文件、缓存、日志文件。 |
| `/extensions` | 用于安装及升级拓展(extensions)。 |
| `/storage` | 存储您上传至网站的文件。 |
| `/themes` | 用于安装及升级主题(themes) |
| `config.php` | 安装器(Installer)将会写入此文件。 |
实际的权限设置取决于用户的服务器运行以及文件夹的所有者。如果你的服务器设置755权限存在问题，你也可以尝试 *775* ，若实在不行则 *777*。
**重要** 你应该尽量避免在正式运行的服务器上设置 *777* 权限，因为这将允许任何人有权访问并任意编辑文件。
### 2. 创建数据库
下一件事，我们需要用类似于 [phpMyAdmin](http://http://www.phpmyadmin.net/) 的工具创建一个为 Pagekit 专门使用的空数据库。如果你的主机仅允许创建一个数据库，并且此数据库已有其他程序在正常使用，你同样可以设置与其不同的表前缀(Pagekit prefixes)以避免冲突。
### 3. 运行安装程序
现在我们已经准备好运行 Pagekit 的安装程序啦！打开浏览器并转到服务器上的 Pagekit 安装页面(`/installer`)。例如：`http://example.com/pagekit/installer`。就这样，让我们进入优美的安装界面吧~
#### 步骤一 - 数据库信息
在安装过程中，我们先给 Pagekit 一些信息来连接数据库。（还记得上一步做的吗？）
| 字段 | 描述 |
|-------|-------------|
| `数据库主机` | 输入数据库主机名，如果网站服务器与数据库服务器于同一台机器上，这里应该填写 *localhost* 或 *127.0.0.1*。 |
| `用户名` | 输入一个可连接至数据库的MySQL用户名。 |
| `密码` | 输入MySQL用户密码。 |
| `数据库名` | 输入数据库名。 |
| `表前缀` | 您可以更改用于数据库表的前缀，默认为`pk_`。 |
#### 步骤二 - 创建用户
为了 Pagekit 创建一个账户吧，此账户将拥有管理员权限。在安装完成后可立即登录 Pagekit 控制面板。
#### 步骤三 - 站点设置
最后，请输入站点名称及对应的描述。你可以通过在网址后添加`/admin`进入登录界面。
## 更新
在执行更新之前，请确定你已做好当前备份的准备。这样做总是可以在特殊情况下将网站恢复至先前的状态。
### 一键升级
你可以用 Pagekit 内置的管理功能更新程序。打开 *设置 > 更新* 并点击 *更新* 按钮。
### 手动更新
下载最新发布的 Pagekit 版本 http://pagekit.com 并直接解压。
现在上传新版程序至服务器，覆盖在 Pagekit 现有文件的文件夹。
为了知晓是否升级成功，只需要进入 *设置 > 信息* 查看。如果一切进行顺利，你应该可以在 *Pagekit 版本* 那看到有些变化。
Enjoy it~

2014年07月30日 08点07分 1