【PHP】Propel的使用,看这一篇就够了

写在前面

本文为学习Propel框架使用的笔记,默认已经安装好Propel环境,若有读者不知如何安装Propel,可参考《听说你PHP配置Composer遇到了一些困境》一文。

Propel初始化

执行propel init指令,进行Propel初始化,若读者执行该指令遇到问题可以参考《【PHP】使用Propel踩过的坑》一文。执行完propel init,需设置数据库类型、IP地址、端口号、数据库名、用户名、密码、编码方式,然后设置相应配置文件的存放位置和命名空间,如下图所示:

CRUD(增删改查)操作

  • Creating Rows 以名为author的表为例,进行插入操作,语句如下:
<?php
$author = new Author();
$author->setFirstName('Jane');
$author->setLastName('Austen');
$author->save();

上述语句等效于:

INSERT INTO author (first_name, last_name) VALUES ('Jane', 'Austen');

通过setXXX()方法插入对应的列,括号中的参数表示插入的值;通过save()方法执行插入语句,这里表和列名都用小写字母+下划线的命名方式。

  • Reading Object Properties Propel支持读取某一条记录的相关信息,并将其语句如下:
<?php
echo $author->getId();        // 1
echo $author->getFirstName(); // 'Jane'
echo $author->getLastName();  // 'Austen'

如果原来数据库表未定义id,则Propel会默认定义一个整型自增的id;通过getXXX()方法得到相应属性(列)的值。除了将属性一个一个显示出来,还提供了便捷的方法将对象以json、yaml、数组、XML、CVS和纯字符串的格式显示出来:

<?php
echo $author->toJSON();
echo $author->toArray();
echo $author->toXML();
echo $author->toYAML();
echo $author->toJSON();
echo $author->toCSV();
echo $author->__toString();

如果想把json数据转为一个对象,可以调用fromJSON(),对应的还有fromArray()fromXML()fromYAML()fromCSV()

  • Retrieving Rows 除了读取对象外,Propel还支持条件查询来读取记录。
    • Retrieving by Primary Key 最简单的使用就是通过主键来读取记录,代码如下:
<?php
$q = new AuthorQuery();
$firstAuthor = $q->findPK(1);

上述代码中AuthorQuery类是在命名空间文件夹里自动生成的。如笔者的命名空间为kq,所以在这个文件夹下会在执行propel init指令时自动生成各种XXXQuery类,如下图所示:

为了引入相关的类,需要将类所在的文件夹在PHP文件通过use引入:

use kq\kq; // use 文件夹\文件夹...;

而变量firstAuthor,如果有找到记录,则它是一个Author对象,如果没有找到,则它为NULL。上述代码实现的效果相当于:

SELECT author.id, author.first_name, author.last_name
FROM `author`
WHERE author.id = 1
LIMIT 1;

和Java语言类似,Propel也提供了工厂模式,上述语句也可以写成工厂模式的形式:

<?php
$firstAuthor = AuthorQuery::create()->findPK(1);

如果想要通过主键查找多条记录,则可以调用findPKs()方法,如下:

<?php
$selectedAuthors = AuthorQuery::create()->findPKs(array(1,2,3,4,5,6,7));

这时候selectedAuthors就是一个Author对象的集合。

  • Querying the Database 除了findPK()方法,读者们还可以通过find()方法来查询记录,如下:
<?php
$authors = AuthorQuery::create()->find();

上述查询得到的结果是author表的所有记录,如果想要通过类似于WHERE的Sql语法筛选记录,可以用filterByXXX()方法实现,其代码实现如下:

<?php
$authors = AuthorQuery::create()
      ->filterByFirstName('Jane')
      ->find();

上述代码得到的authors对象可用foreach来遍历:

foreach($authors as $author) {
        echo $author->getFirstName();
}

Sql语句中有ORDER BYLIMIT语法,在Propel中可通过orderByXXX()方法和limit()方法实现:

<?php
$authors = AuthorQuery::create()
      ->orderByLastName()
      ->limit(10)
      ->find();

如果想实现limit(1)的效果,可直接调用findOne()

<?php
$author = AuthorQuery::create()
      ->filterByFirstName('Jane')
      ->findOne();

上述语句可简写为一行:

<?php
$author = AuthorQuery::create()->findOneByFirstName('Jane');
  • Using Custom SQL Propel作为orm框架,其提供的方法在给我们带来便利的同时也带来了局限。为了避免这种限制,Propel提供了自定义Sql语句的执行方法:
<?php
use Propel\Runtime\Propel;
$con = Propel::getWriteConnection(\Map\BookTableMap::DATABASE_NAME);
$sql = "SELECT * FROM book WHERE id NOT IN "
        ."(SELECT book_review.book_id FROM book_review"
        ." INNER JOIN author ON (book_review.author_id=author.ID)"
        ." WHERE author.last_name = :name)";
$stmt = $con->prepare($sql);
$stmt->execute(array(':name' => 'Austen'));
// 上述代码执行的是查找作者姓氏不为`Austen`的书籍。

自定义Sql语句执行得到的是一个结果集(resultset),如果想把结果集转为对象,可以调用ObjectFormatter类的format方法:

<?php
use Propel\Runtime\Formatter\ObjectFormatter;
$con = Propel::getWriteConnection(\Map\BookTableMap::DATABASE_NAME);
$formatter = new ObjectFormatter();
$formatter->setClass('\Book'); 
$books = $formatter->format($con->getDataFetcher($stmt));

划重点:使用自定义的Sql语句需要注意以下三点: * 结果集列必须是数字索引(The resultset columns must be numerically indexed) * 结果集必须包含数据表的所有列,延迟加载的列除外(The resultset must contain all the columns of the table (except lazy-load columns)) * 结果集必须按照scheme.xml文件指定的顺序以相同排序方式排序(The resultset must have columns in the same order as they are defined in the schema.xml file)

PS: 对于上述第一点,笔者不理解其表达的意思,望过来人指点一二。
  • Updating Objects 修改数据库基于读取数据库,通过读取获取对象,再通过setXXX()save()方法对对象属性进行修改并存入数据库:
<?php
$author = AuthorQuery::create()->findOneByFirstName('Jane');
$author->setLastName('Austen');
$author->save();

除上述方法外,Propel提供了update()方法,直接对数据进行修改:

<?php
AuthorQuery::create()
      ->filterByFirstName('Jane')
      ->update(array('LastName' => 'Austen'));

官方推荐使用update()方法对数据做修改

  • Deleting Objects 删除数据记录与修改数据类似,也是通过读取获取对象,再调用delete()方法对数据进行删除:
<?php
$author = AuthorQuery::create()->findOneByFirstName('Jane');
$author->delete();

同样,上述代码还可以优雅地写为:

<?php
AuthorQuery::create()
      ->filterByFirstName('Jane')
      ->delete();

敲黑板!!!这里注意一点,被删除的对象(如上面代码中的author对象),依然可以通过getXXX()方法获取被删除的记录的属性值:

<?php
echo $author->isDeleted();    // true
echo $author->getFirstName(); // 'Jane'
  • Query Termination Methods 像上述提到的find()update()delete()这样不返回当前对象的方法称之为“终止方法(Termination Methods)”(官网原文:The Query methods that don’t return the current query object are called “Termination Methods”)。除了上述提到的终止方法外,还有两个方法:http://propelorm.org/documentation/03-basic-crud.html
    • count() 该方法返回查询结果的记录条数:
<?php
$nbAuthors = AuthorQuery::create()->count();
  • paginate() 通过调用该方法,传入当前页和每页记录条数可实现实现分页的效果:
<?php
$authorPager = AuthorQuery::create()->paginate($page = 1, $maxPerPage = 10);
foreach ($authorPager as $author) {
      echo $author->getFirstName();
}

pager对象可以有以下方法可以调用:

<?php
// total number of results if not paginated
echo $pager->getNbResults();
// 如果maxPerPage小于总的条数,则返回true;否则反之
echo $pager->haveToPaginate(); 
// 返回第一页记录
echo $pager->getFirstIndex(); 
// 返回最后一页记录
echo $pager->getLastIndex();
 // array of page numbers around the current page; useful to display pagination controls
$links = $pager->getLinks(5); 
# 对于第一个方法和最后一个方法,笔者担心自己误人子弟,读者们可以根据英文注解,实际动手写一下代码验证一下
  • Collections And On-Demand Hydration Propel对数据查询进行了优化,当查询数据量比较大时,Propel提供了“按需分配”的机制,这样防止了内存溢出的现象,其代码实现上只需要加入一句代码即可:
<?php
$authors = AuthorQuery::create()
  ->limit(50000)
  ->setFormatter(ModelCriteria::FORMAT_ON_DEMAND) // just add this line
  ->find();
foreach ($authors as $author) {
      echo $author->getFirstName();
}

ModelCriteria::FORMAT_ON_DEMAND用在与对象相关的查询中,如果将查询到的数据存在数组中,可以使用ModelCriteria::FORMAT_ARRAY

  • Propel Instance Pool 为了防止在同一个PHP脚本文件中用到多个相同的数据查询,Propel提供了“实例池(Instance Pool)”的概念,如下面代码,执行完一条查询一句后,再此执行,则第二次直接调用第一次的实例:
<?php
// first call
$author1 = AuthorQuery::create()->findPk(1);
// Issues a SELECT query
...
// second call
$author2 = AuthorQuery::create()->findPk(1);
// Skips the SQL query and returns the existing $author1 object

参考链接

http://propelorm.org/documentation/03-basic-crud.html


本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Golang语言社区

go语言的sql包原理与用法分析

go的sql包是在pkg/database中,里面的两个包sql和sql/driver可以一起看。建议看这个两个包之前可以先看看sql文件夹下的doc.txt。...

2984
来自专栏Golang语言社区

go语言的sql包原理与用法分析

本文实例讲述了go语言的sql包原理与用法。分享给大家供大家参考,具体如下: go的sql包是在pkg/database中,里面的两个包sql和sql/driv...

4436
来自专栏机器学习从入门到成神

Java知识点总结

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/sinat_35512245/articl...

1471
来自专栏技术博客

Entity Framework DataAnnotations

DataAnnotation 特性由.NET 3.5中引进,给.NET中的类提供了一种添加验证的方式。但是在EF中它又可以对映射关系进行控制,相比较Fluent...

833
来自专栏用户2442861的专栏

初学Redis(2)——用Redis作为Mysql数据库的缓存

http://blog.csdn.net/qtyl1988/article/details/39519951

1552
来自专栏Hongten

python开发_pickle

pickle模块使用的数据格式是python专用的,并且不同版本不向后兼容,同时也不能被其他语言说识别。要和其他语言交互,可以使用内置的json包使用pickl...

932
来自专栏Ryan Miao

mysql插入日期 vs oracle插入日期

今天做oracle日期插入的时候突然开始疑惑日期是如何插入的。 用框架久了,反而不自己做简单的工作了。比如插入。 通常,新建一个表对象,然后绑定数据,前端for...

3079
来自专栏Greenplum

Greenplum 对JSON的支持

源文章:http://www.postgresqltutorial.com/postgresql-json/

721
来自专栏用户2442861的专栏

[疯狂Java]JDBC:PreparedStatement预编译执行SQL语句

    1) SQL语句和编程语言一样,仅仅就会普通的文本字符串,首先数据库引擎无法识别这种文本字符串,而底层的CPU更不理解这些文本字符串(只懂二进制机器指...

2482
来自专栏逸鹏说道

如何让所有实体类用相同名称的主键(很有力的问题,比如所有表实体主键都用ID)

这个问题比较有力量,哈哈! 例如:有两个表userbases和products 两个表的主键分别为UserID和ProductID,那么,我想问有没有一种方法把...

3115

扫码关注云+社区