php文章api系统,用Yaapi和PHP构建一个简单的内容管理系统-PHP教程,其它文章

如果你是一个正在构建具有丰富内容的web网站的开发人员，你就可能需要考虑下面这些解决方案，其中包括(a)用于内容的数据库，(b)将gui与内容分离的模板系统，(c)用来维护数据库里数据的用户友好界面，以及(d)对所生成页面的最终外观的控制。

能够提供上述所有内容的一个非常有趣的解决方案就是yaapi，它是“你的文章应用程序编程接口(your article application programming interface)”的开头字母缩写。它是一个php类，提供了内置的方法来访问保存在数据库里的内容。管理模块装备有协助管理数据的类，而这个api本身都足够强大，可能够处理内容管理系统(cms)所要求的大多数常见任务。

安装

要安装和使用yaapi，你需要一个支持php的web服务器，例如apache，当然还有php，以及mysql数据库服务器。你可以下载一份yaapi，将它解压到服务器根目录下的某个位置里。

你还需要创建一个mysql数据库，以容纳yaapi的数据结构。使用源档案里的yaapi.sql文件创建这个数据库，然后打开类构造函数(article.class.php文件)里的yaapi配置，使用用于该数据库的名字和访问参数更新它。

添加内容

要向数据库里添加内容，你就必须使用http://your-server/yaapi-root/admin/上的yaapi管理模块(用安装有yaapi的服务器的名称来替换“your-server”，并用yaapi解压后的目录来替换“yaapi-root”)。你要使用这个管理模块来创建(和删除)内容类别，然后把文章放到这些类别里。下面就是你会在这一过程中碰到的字段的简表：

类别(category)：文章的类别

章节id(section id)：如果你的文章有两个层次，就要使用这个参数来定义第二个层次。

标题(title)：文章的标题

作者(author)：文章的作者

电子邮件(e-mail)：文章作者的电子邮件地址

许可(approved)：用来表示文章是否已经“得到许可”可以进行显示的标志

图像(image)：与文章相关的可选图像url

内容(content)：文章的内容

关于上面最后一个项目的一点小小注释：通过在文章文本里插入分隔符，yaapi能够把你的大段文章分在若干个小的页面里进行显示。见下面的例子：

introduction of article here

#intro#

page 1 content here

#page#

page 2 content here

#page#

page 3 content here

#page#

and so on…

别忘了在输入文章之后确认一下，因为只有经过确认的文章才能够用api检索得到。

检索类别和列表

既然你已经把内容放到了数据库里，那么现在就到了用api检索它并填充一个标准的html模板(可以对这个模板进行修改，以符合你网站的设计)的时候了。列表a里是该模板的基本代码。

一开始你可以使用yaapi来检索某个特定类别里所有文章的列表，并在中间显示它们的标题、作者和简介。列表b里是php代码和实现这一代码的yaapi api调用。这段代码需要稍稍解释一下。

在使用yaapi的时候，所要做的第一步是对类的对象进行实例化；这个对象然后就会公开api方法和属性，用以访问数据库里的内容。为了获取标题的列表，你可以使用类别id。后者可以通过url传递或者是一个缺省的值。get_titles()方法用这个类别id来返回一个相关联的数组，其中包含该类别里的文章id和(经过确认的)文章标题。

然后，get_article()方法会更加深入一步，在上一步里返回的文章id列表里迭代，并返回代表每篇文章的对象。(文章)标题、作者细节和介绍都被作为对象的属性公开，并能够用标准的对象属性概念被检索。要注意的是，文章标题被更进一步通过文章id对象链接到一个单独php脚本——article.php上。关于这一内容不久会有更多的介绍。

——————————————————————————–

提示

你可以向get_article()方法传递可选的第二个参数，即页面标号，用来返回文章的一个专门页面。

——————————————————————————–

要完成这个页面上的工作，剩下要做的所有事情就是取得和打印可用类别的列表(要记住，你左边的菜单需要这个列表)。你可以使用get_categories()方法来完成这一工作，这个方法会返回一个相关的数组，里面包含类别的名称以及它们各自的id。列表c包含从列表b到这个脚本所需要的更新。

在图a里，你可以看到最终的结果：

检索文章的内容

完整文章的显示由article.php脚本来处理，这个脚本要用文章id来调用。列表d包括这个脚本的代码，其中包括对页面分隔符的支持，这是通过允许你利用页面底部的页码跳到文章任何页面来实现的。

每个页面的内容通过前面讨论的get_article()方法来检索。唯一的不同之处是，所返回对象的“内容”属性现在将会保存文章的一个特定页面，而不是简介。

num_pages()这个属性被用来获取文章的页面总数。这可以同一个简单的for()循环结合在一起生成一个页码导航条和超链接，每一个都可以回到相同的脚本，它们都具有相同的文章id，但是不同的页面id。

图b显示了输出结果是什么样的：