Z-Blog Wiki Z-Blog Wiki

Z-Blog官方文库

用户工具

站点工具


zblogphp:development:functions:getpost

GetPost 函数

通过GetPost 可以获取指定的文章或页面或是其它类型的Post表的数据

1.7新版本的语法及参数

//返回id为10的Post对象实例,如果没有就返回一个空的Post对象实例
$post = GetPost(array('id'=>10)) //返回object(Post类型)

array参数如下

array(
  'id' => 10, //指定ID(可省略)
  'title' => 'abc', //指定Post标题(可省略)
  'alias' => 'cba', //指定Post别名(可省略) 
  'titleoralias' => 'ddd', //指定Post标题or别名(可省略)
  'idorname' => 'fff', //指定Post的ID或标题or别名(可省略)
  //以下是原$option参数的key键
  'post_type' => null, //指定查询Post表的类型 (可省略)
  'post_status' => null, //指定查询Post表的状态 (可省略)
  'only_article' => false, //指定是查找文章 (可省略)
  'only_page' => false, //指定是查找页面 (可省略)
  'where_custom' => array(array('=', 'log_Template', '')), //自定义where
  'order_custom' => array('log_CommNums' => 'ASC'), //自定义order
)

1.6版本及更早的语法

$post = GetPost($idorname, $option = null)

调用参数

参数类型 参数 默认值 描述
mixed$idorname 文章ID、标题或者别名
array$option null附加选项

参数说明

option

option参数可指定更多配置选项,默认均为false,参考如下

$option = array (
    "only_article"  => true //只检索文章
    //"only_page"  => true  //只检索页面
);
:!:两个选项同时为true时只有only_article选项有效。

返回值

返回指定的Post实例,若存在同名的文章或页面则只返回第一个结果,若指定的文章不存在则返回空的Post实例。

代码示例

例1

获取ID为10的文章

$post=GetPost(10);
使用变量为id时,要用int传递才能正常显示,如下$id是已经被指定字符串变量,则通过下面这种方式才能使用:
$post=GetPost((int)$id);

例2

搜索文章标题或别名为“abc”的文章(设定选项为不检索页面)

$post=GetPost("abc",array('only_article'=>true));

例3

在模板中,获取并输出获取到的页面(假设是为获取aboutme页面数据)代码参考如下

{$aboutme=GetPost("aboutme",array('only_page'=>true));}
<div id="about">
<h3 class="title">{$aboutme.Title}</h3>
<div class="content">{$aboutme.Intro}</div>
</div>

zblogphp/development/functions/getpost.txt · 最后更改: 2021/01/16 14:47 (外部编辑)