https://docs.sandbox.joomla.org/api.php?action=feedcontributions&feedformat=atom&user=Guozhanfeng
Joomla! Documentation - User contributions [en]
2026-07-09T20:36:53Z
User contributions
MediaWiki 1.43.0
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/139/zh-cn&diff=481620
Translations:Selecting data using JDatabase/139/zh-cn
2018-03-31T07:01:13Z
<p>Guozhanfeng: Created page with "Joomla CMS 3.8 API"</p>
<hr />
<div>Joomla CMS 3.8 API</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481619
Selecting data using JDatabase/zh-cn
2018-03-31T07:01:12Z
<p>Guozhanfeng: Created page with "在数据库查询中使用union方法"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
将返回 <pre>3</pre><br />
注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP警告:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== 另请参阅 ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|使用JDatabase插入、更新和删除数据。]]<br />
*[[S:MyLanguage/Using the union methods in database queries|在数据库查询中使用union方法]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/138/zh-cn&diff=481618
Translations:Selecting data using JDatabase/138/zh-cn
2018-03-31T07:01:10Z
<p>Guozhanfeng: Created page with "(Joomla! 3.3+)"</p>
<hr />
<div>(Joomla! 3.3+)</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/137/zh-cn&diff=481617
Translations:Selecting data using JDatabase/137/zh-cn
2018-03-31T07:01:08Z
<p>Guozhanfeng: Created page with "在数据库查询中使用union方法"</p>
<hr />
<div>在数据库查询中使用union方法</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481616
Selecting data using JDatabase/zh-cn
2018-03-31T07:01:04Z
<p>Guozhanfeng: Created page with "使用JDatabase插入、更新和删除数据。"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
将返回 <pre>3</pre><br />
注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP警告:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== 另请参阅 ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|使用JDatabase插入、更新和删除数据。]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/136/zh-cn&diff=481615
Translations:Selecting data using JDatabase/136/zh-cn
2018-03-31T07:01:01Z
<p>Guozhanfeng: Created page with "使用JDatabase插入、更新和删除数据。"</p>
<hr />
<div>使用JDatabase插入、更新和删除数据。</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481614
Selecting data using JDatabase/zh-cn
2018-03-31T07:01:00Z
<p>Guozhanfeng: Created page with "=== 另请参阅 ==="</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
将返回 <pre>3</pre><br />
注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP警告:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== 另请参阅 ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/135/zh-cn&diff=481613
Translations:Selecting data using JDatabase/135/zh-cn
2018-03-31T07:00:54Z
<p>Guozhanfeng: Created page with "=== 另请参阅 ==="</p>
<hr />
<div>=== 另请参阅 ===</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481612
Selecting data using JDatabase/zh-cn
2018-03-31T07:00:51Z
<p>Guozhanfeng: Created page with "注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP..."</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
将返回 <pre>3</pre><br />
注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP警告:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/131/zh-cn&diff=481611
Translations:Selecting data using JDatabase/131/zh-cn
2018-03-31T07:00:46Z
<p>Guozhanfeng: Created page with "注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP..."</p>
<hr />
<div>注意: getNumRows() 只对选择或显示返回实际结果集的语句有效 getNumRows() after loadRowList() - 或者任何其他的检索方法——您将得到一个PHP警告:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481610
Selecting data using JDatabase/zh-cn
2018-03-31T07:00:17Z
<p>Guozhanfeng: Created page with "将返回"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
将返回 <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/130/zh-cn&diff=481609
Translations:Selecting data using JDatabase/130/zh-cn
2018-03-31T07:00:14Z
<p>Guozhanfeng: Created page with "将返回"</p>
<hr />
<div>将返回</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481608
Selecting data using JDatabase/zh-cn
2018-03-31T07:00:06Z
<p>Guozhanfeng: Created page with "<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''b..."</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/129/zh-cn&diff=481607
Translations:Selecting data using JDatabase/129/zh-cn
2018-03-31T07:00:02Z
<p>Guozhanfeng: Created page with "<tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''b..."</p>
<hr />
<div><tt>getNumRows()</tt> 将返回最后一个SELECT或SHOW查询所发现的结果行数，并等待读取。得到结果 getNumRows() 你必须运行 '''after''' 查询和 '''before''' 您已经检索到任何结果。检索受影响的行数 INSERT, UPDATE, REPLACE 或 DELETE 查询,使用getAffectedRows().</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481606
Selecting data using JDatabase/zh-cn
2018-03-31T06:58:32Z
<p>Guozhanfeng: Created page with "=== 其他结果集方法 ==="</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== 其他结果集方法 ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/128/zh-cn&diff=481605
Translations:Selecting data using JDatabase/128/zh-cn
2018-03-31T06:58:30Z
<p>Guozhanfeng: Created page with "==== getNumRows() ===="</p>
<hr />
<div>==== getNumRows() ====</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/127/zh-cn&diff=481604
Translations:Selecting data using JDatabase/127/zh-cn
2018-03-31T06:58:28Z
<p>Guozhanfeng: Created page with "=== 其他结果集方法 ==="</p>
<hr />
<div>=== 其他结果集方法 ===</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481603
Selecting data using JDatabase/zh-cn
2018-03-31T06:58:19Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/126/zh-cn&diff=481602
Translations:Selecting data using JDatabase/126/zh-cn
2018-03-31T06:58:16Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div>注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481601
Selecting data using JDatabase/zh-cn
2018-03-31T06:58:01Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/125/zh-cn&diff=481600
Translations:Selecting data using JDatabase/125/zh-cn
2018-03-31T06:57:57Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div>你可以通过使用来访问单个值：</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481599
Selecting data using JDatabase/zh-cn
2018-03-31T06:57:03Z
<p>Guozhanfeng: Created page with "您可以通过以下方式访问单个行:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/124/zh-cn&diff=481598
Translations:Selecting data using JDatabase/124/zh-cn
2018-03-31T06:56:56Z
<p>Guozhanfeng: Created page with "您可以通过以下方式访问单个行:"</p>
<hr />
<div>您可以通过以下方式访问单个行:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481597
Selecting data using JDatabase/zh-cn
2018-03-31T06:56:54Z
<p>Guozhanfeng: Created page with "<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/123/zh-cn&diff=481596
Translations:Selecting data using JDatabase/123/zh-cn
2018-03-31T06:56:53Z
<p>Guozhanfeng: Created page with "将给予(为了清晰起见，添加换行符):"</p>
<hr />
<div>将给予(为了清晰起见，添加换行符):</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/122/zh-cn&diff=481595
Translations:Selecting data using JDatabase/122/zh-cn
2018-03-31T06:56:50Z
<p>Guozhanfeng: Created page with "<tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:"</p>
<hr />
<div><tt>loadObjectList('key')</tt> 返回一个关联数组 - indexed on 'key' - 查询返回的表记录中的对象:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481594
Selecting data using JDatabase/zh-cn
2018-03-31T06:56:24Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/121/zh-cn&diff=481593
Translations:Selecting data using JDatabase/121/zh-cn
2018-03-31T06:56:22Z
<p>Guozhanfeng: Created page with "==== loadObjectList($key) ===="</p>
<hr />
<div>==== loadObjectList($key) ====</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/120/zh-cn&diff=481592
Translations:Selecting data using JDatabase/120/zh-cn
2018-03-31T06:56:20Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div>你可以通过使用来访问单个值：</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/119/zh-cn&diff=481591
Translations:Selecting data using JDatabase/119/zh-cn
2018-03-31T06:56:18Z
<p>Guozhanfeng: Created page with "您可以通过以下方式访问单个行:"</p>
<hr />
<div>您可以通过以下方式访问单个行:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481590
Selecting data using JDatabase/zh-cn
2018-03-31T06:56:16Z
<p>Guozhanfeng: Created page with "<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/118/zh-cn&diff=481589
Translations:Selecting data using JDatabase/118/zh-cn
2018-03-31T06:56:15Z
<p>Guozhanfeng: Created page with "将给予(为了清晰起见，添加换行符):"</p>
<hr />
<div>将给予(为了清晰起见，添加换行符):</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/117/zh-cn&diff=481588
Translations:Selecting data using JDatabase/117/zh-cn
2018-03-31T06:56:13Z
<p>Guozhanfeng: Created page with "<tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:"</p>
<hr />
<div><tt>loadObjectList()</tt> 从查询返回的表记录返回一个已索引的PHP对象数组:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481587
Selecting data using JDatabase/zh-cn
2018-03-31T06:55:58Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/116/zh-cn&diff=481586
Translations:Selecting data using JDatabase/116/zh-cn
2018-03-31T06:55:57Z
<p>Guozhanfeng: Created page with "==== loadObjectList() ===="</p>
<hr />
<div>==== loadObjectList() ====</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/115/zh-cn&diff=481585
Translations:Selecting data using JDatabase/115/zh-cn
2018-03-31T06:55:55Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div>注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481584
Selecting data using JDatabase/zh-cn
2018-03-31T06:55:45Z
<p>Guozhanfeng: Created page with "<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/114/zh-cn&diff=481583
Translations:Selecting data using JDatabase/114/zh-cn
2018-03-31T06:55:45Z
<p>Guozhanfeng: Created page with "将给予(为了清晰起见，添加换行符):"</p>
<hr />
<div>将给予(为了清晰起见，添加换行符):</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/113/zh-cn&diff=481582
Translations:Selecting data using JDatabase/113/zh-cn
2018-03-31T06:55:42Z
<p>Guozhanfeng: Created page with "<tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:"</p>
<hr />
<div><tt>loadAssocList('key', 'column')</tt> 返回由查询返回的列“列”的“键”上的值的关联数组:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481581
Selecting data using JDatabase/zh-cn
2018-03-31T06:55:34Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
你可以通过使用来访问单个值：<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> returns an associative array, indexed on 'key', of values from the column named 'column' returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/112/zh-cn&diff=481580
Translations:Selecting data using JDatabase/112/zh-cn
2018-03-31T06:55:32Z
<p>Guozhanfeng: Created page with "==== loadAssocList($key, $column) ===="</p>
<hr />
<div>==== loadAssocList($key, $column) ====</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/111/zh-cn&diff=481579
Translations:Selecting data using JDatabase/111/zh-cn
2018-03-31T06:55:30Z
<p>Guozhanfeng: Created page with "注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。"</p>
<hr />
<div>注意:键必须是来自表的有效列名;它不必是索引或主键。但是如果它没有唯一的值，您可能无法可靠地检索结果。</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481578
Selecting data using JDatabase/zh-cn
2018-03-31T06:55:23Z
<p>Guozhanfeng: Created page with "您可以通过以下方式访问单个行:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> returns an associative array, indexed on 'key', of values from the column named 'column' returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/110/zh-cn&diff=481577
Translations:Selecting data using JDatabase/110/zh-cn
2018-03-31T06:55:21Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div>你可以通过使用来访问单个值：</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/109/zh-cn&diff=481576
Translations:Selecting data using JDatabase/109/zh-cn
2018-03-31T06:55:18Z
<p>Guozhanfeng: Created page with "您可以通过以下方式访问单个行:"</p>
<hr />
<div>您可以通过以下方式访问单个行:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481575
Selecting data using JDatabase/zh-cn
2018-03-31T06:55:15Z
<p>Guozhanfeng: Created page with "<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:"</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> returns an associative array, indexed on 'key', of values from the column named 'column' returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/108/zh-cn&diff=481574
Translations:Selecting data using JDatabase/108/zh-cn
2018-03-31T06:55:15Z
<p>Guozhanfeng: Created page with "将给予(为了清晰起见，添加换行符):"</p>
<hr />
<div>将给予(为了清晰起见，添加换行符):</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/107/zh-cn&diff=481573
Translations:Selecting data using JDatabase/107/zh-cn
2018-03-31T06:55:11Z
<p>Guozhanfeng: Created page with "<tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:"</p>
<hr />
<div><tt>loadAssocList('key')</tt> 返回一个关联数组 - indexed on 'key' - 由查询返回的表记录中的关联数组:</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Translations:Selecting_data_using_JDatabase/106/zh-cn&diff=481572
Translations:Selecting data using JDatabase/106/zh-cn
2018-03-31T06:53:53Z
<p>Guozhanfeng: Created page with "==== loadAssocList($key) ===="</p>
<hr />
<div>==== loadAssocList($key) ====</div>
Guozhanfeng
https://docs.sandbox.joomla.org/index.php?title=Selecting_data_using_JDatabase/zh-cn&diff=481571
Selecting data using JDatabase/zh-cn
2018-03-31T06:53:44Z
<p>Guozhanfeng: Created page with "你可以通过使用来访问单个值："</p>
<hr />
<div><noinclude><languages /></noinclude><br />
<noinclude>{{Joomla version|version=3.x}}{{Joomla version|version=2.5|status=eos}}</noinclude><br />
{{-}}<br />
{{tip|注意许多在线使用的例子<code>$db->query()</code> 而不是<code>$db->execute()</code>. 这是Joomla 1.5和2.5中的旧方法，将在Joomla 3.0+中抛出一个弃用的通知。|title=注意版本}}<br />
<br />
本教程分为两个独立部分:<br />
*插入、更新和删除数据库中的数据。<br />
* 从一个或多个表中选择数据并以各种不同的形式检索数据。<br />
<br />
文档的这一部分着眼于从数据库表中选择数据并以各种格式检索数据。看另一部分。[[S:MyLanguage/Inserting,_Updating_and_Removing_data_using_JDatabase|点击这里]]<br />
<br />
== 介绍 ==<br />
Joomla提供了一个复杂的数据库抽象层，以简化第三方开发人员的使用。Joomla平台API的新版本提供了额外的功能，可以进一步扩展数据库层，并包括一些特性，例如连接器到更多种数据库服务器和查询链接，以提高连接代码的可读性和简化SQL编码。<br />
<br />
Joomla可以使用不同类型的SQL数据库系统，并在不同的环境中运行不同的表前缀。除了这些函数之外，该类还自动创建数据库连接。除了实例化对象之外，还需要两行代码以各种格式从数据库获取结果。使用Joomla数据库层确保您的扩展具有最大的兼容性和灵活性。<br />
<br />
==查询==<br />
Joomla的数据库查询随着Joomla 1.6的引入而改变。构建数据库查询的建议方法是通过“查询链接”(尽管仍然支持字符串查询)。<br />
<br />
查询链接是一种连接多种方法的方法，一个接一个，每个方法返回一个对象，该对象可以支持下一个方法，提高可读性和简化代码。<br />
<br />
为了获得JDatabaseQuery类的新实例，我们使用JDatabaseDriver getQuery方法:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
<br />
$query = $db->getQuery(true);<br />
</source><br />
<br />
JDatabaseDriver::getQuery接受一个可选的参数,$new, 这可能是真或假(默认为假)。<br />
<br />
要查询我们的数据源，我们可以调用一些JDatabaseQuery方法;这些方法封装了数据源的查询语言(在大多数情况下是SQL)，从开发人员那里隐藏了查询特定的语法，并提高了开发人员源代码的可移植性。 <br />
<br />
一些比较常用的方法包括;选择，从，连接，在哪里和顺序。还有一些方法，比如在数据存储中修改记录的插入、更新和删除。通过链接这些方法和其他方法调用，您可以在不影响代码的可移植性的情况下创建几乎所有针对数据存储的查询。.<br />
<br />
==从单个表中选择记录==<br />
<br />
下面是一个使用该方法创建数据库查询的示例 <tt>JDatabaseQuery</tt> 类。使用select、from、where和order方法，我们可以创建灵活、易读和可移植的查询:<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all records from the user profile table where key begins with "custom.".<br />
// Order it by the ordering field.<br />
$query->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')));<br />
$query->from($db->quoteName('#__user_profiles'));<br />
$query->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''));<br />
$query->order('ordering ASC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
该查询还可以被链接，以进一步简化:<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->where($db->quoteName('profile_key') . ' LIKE '. $db->quote('\'custom.%\''))<br />
->order('ordering ASC');<br />
</source><br />
<br />
当查询变得更长和更复杂时，链接将变得有用。<br />
<br />
分组也可以简单地实现。下面的查询将计算每个类别中的文章数量。<br />
<br />
<source lang="php"><br />
$query<br />
->select( array('catid', 'COUNT(*)') )<br />
->from($db->quoteName('#__content'))<br />
->group($db->quoteName('catid'));<br />
</source><br />
<br />
可以使用“setLimit”设置一个查询的限制。例如，在以下查询中，它将返回多达10条记录。<br />
<br />
<source lang="php"><br />
$query<br />
->select($db->quoteName(array('user_id', 'profile_key', 'profile_value', 'ordering')))<br />
->from($db->quoteName('#__user_profiles'))<br />
->setLimit('10');<br />
</source><br />
<br />
==从多个表中选择记录==<br />
使用JDatabaseQuery的 [http://api.joomla.org/11.4/Joomla-Platform/Database/JDatabaseQuery.html#join join] 方法，我们可以从多个相关的表中选择记录。泛型“join”方法接受两个参数;连接“类型”(内、外、左、右)和连接条件。在下面的示例中，您将注意到，如果我们编写一个原生SQL查询，我们可以使用我们通常使用的所有关键字，包括作为别名表的关键字，以及用于创建表之间关系的ON关键字。还要注意，表别名用于所有引用表列(即select、where、order)的方法。<br />
<br />
<source lang="php"><br />
// Get a db connection.<br />
$db = JFactory::getDbo();<br />
<br />
// Create a new query object.<br />
$query = $db->getQuery(true);<br />
<br />
// Select all articles for users who have a username which starts with 'a'.<br />
// Order it by the created date.<br />
// Note by putting 'a' as a second parameter will generate `#__content` AS `a`<br />
$query<br />
->select(array('a.*', 'b.username', 'b.name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
<br />
// Load the results as a list of stdClass objects (see later for more options on retrieving data).<br />
$results = $db->loadObjectList();<br />
</source><br />
<br />
上面的连接方法使我们能够查询内容和用户表，检索文章的作者详细信息。还有一些方便的连接方法:<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_innerJoin innerJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_leftJoin leftJoin()]<br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_rightJoin rightJoin()] <br />
* [http://api.joomla.org/cms-3/classes/JDatabaseQuery.html#method_outerJoin outerJoin()]<br />
<br />
我们可以使用多个连接来查询超过两个表:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*', 'b.username', 'b.name', 'c.*', 'd.*'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->join('LEFT', $db->quoteName('#__user_profiles', 'c') . ' ON (' . $db->quoteName('b.id') . ' = ' . $db->quoteName('c.user_id') . ')')<br />
->join('RIGHT', $db->quoteName('#__categories', 'd') . ' ON (' . $db->quoteName('a.catid') . ' = ' . $db->quoteName('d.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
请注意，链接是如何使源代码在这些较长的查询中更具可读性的。<br />
<br />
在某些情况下，您还需要在选择项时使用AS子句，以避免列名称冲突。在这种情况下，可以将多个select语句与使用第二个参数连接起来$db->quoteName.<br />
<br />
<source lang="php"><br />
$query<br />
->select('a.*')<br />
->select($db->quoteName('b.username', 'username'))<br />
->select($db->quoteName('b.name', 'name'))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
第二个数组也可以作为select语句的第二个参数来填充as子句的值。记住，在第二个数组中包含null，以对应第一个数组中的列，您不想使用AS子句:<br />
<br />
<source lang="php"><br />
$query<br />
->select(array('a.*'))<br />
->select($db->quoteName(array('b.username', 'b.name'), array('username', 'name')))<br />
->from($db->quoteName('#__content', 'a'))<br />
->join('INNER', $db->quoteName('#__users', 'b') . ' ON (' . $db->quoteName('a.created_by') . ' = ' . $db->quoteName('b.id') . ')')<br />
->where($db->quoteName('b.username') . ' LIKE \'a%\'')<br />
->order($db->quoteName('a.created') . ' DESC');<br />
</source><br />
<br />
<br />
==查询结果 ==<br />
数据库类包含许多处理查询结果集的方法。<br />
<br />
=== 单值的结果 ===<br />
==== loadResult() ====<br />
使用 '''loadResult()''' 当您期望从数据库查询返回单个值时。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
这通常是“count”查询的结果，以获得一些记录:<br />
<br />
<source lang="php"><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('COUNT(*)');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('name')." = ".$db->quote($value));<br />
<br />
// Reset the query using our newly populated query object.<br />
$db->setQuery($query);<br />
$count = $db->loadResult();<br />
</source><br />
或者，您只需要从表的单行中查找单个字段(或者从第一行返回的单个字段)。<br />
<source lang='php'><br />
$db = JFactory::getDbo();<br />
$query = $db->getQuery(true);<br />
$query->select('field_name');<br />
$query->from($db->quoteName('#__my_table'));<br />
$query->where($db->quoteName('some_name')." = ".$db->quote($some_value));<br />
<br />
$db->setQuery($query);<br />
$result = $db->loadResult();<br />
</source><br />
<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个记录，尽管可能有几条记录符合您设置的标准。<br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRow() ====<br />
<tt>loadRow()</tt> 从表中的单个记录返回一个索引数组: <br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRow();<br />
print_r($row);<br />
</source><br />
将:<br />
<pre>Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ) </pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['index'] // e.g. $row['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadAssoc() ====<br />
<tt>loadAssoc()</tt> 从表中的单个记录返回一个相关联的数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssoc();<br />
print_r($row);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$row['name'] // e.g. $row['email']</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
==== loadObject() ====<br />
loadObject从表中的单个记录返回一个PHP对象:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$result = $db->loadObject();<br />
print_r($result);<br />
</source><br />
<br />
将:<br />
<pre>stdClass Object ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$result->index // e.g. $result->email</pre><br />
<br />
注释:<br />
# 虽然您可以重复调用以获得更多的行，但返回多行的函数之一可能更有用。<br />
<br />
===单行结果 ===<br />
每个结果函数都将从数据库返回单个列。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- <br />
| 1 || style="background:yellow" | John Smith || johnsmith@domain.example || johnsmith<br />
|-<br />
| 2 || style="background:yellow" | Magda Hellman || magda_h@domain.example || magdah<br />
|-<br />
| 3 || style="background:yellow" | Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadColumn() ====<br />
<tt>loadColumn()</tt> 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select('name'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn();<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
注释:<br />
# 数组索引是从0开始的数值。<br />
# <tt>loadColumn()</tt> 相当于 loadColumn(0).<br />
<br />
==== loadColumn($index) ====<br />
loadColumn($index) 从表中的单个列返回一个索引数组:<br />
<br />
<source lang='php'><br />
$query->select(array('name', 'email', 'username'));<br />
->from . . .";<br />
. . .<br />
$db->setQuery($query);<br />
$column= $db->loadColumn(1);<br />
print_r($column);<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example )</pre><br />
<br />
您可以通过以下方式访问单个值:<pre>$column['index'] // e.g. $column['2']</pre><br />
<br />
loadColumn($index) 允许您遍历结果中的一系列。<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
for ( $i = 0; $i <= 2; $i++ ) {<br />
$column= $db->loadColumn($i);<br />
print_r($column);<br />
}<br />
</source><br />
<br />
将:<br />
<pre>Array ( [0] => John Smith, [1] => Magda Hellman, [2] => Yvonne de Gaulle ),<br />
Array ( [0] => johnsmith@domain.example, [1] => magda_h@domain.example, [2] => ydg@domain.example ),<br />
Array ( [0] => johnsmith, [1] => magdah, [2] => ydegaulle )</pre><br />
</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
=== 多行结果 ===<br />
每个结果函数都将从数据库返回多个记录。 <br />
<br />
{| class="wikitable" style="text-align:center"<br />
|-<br />
! id !! name !! email !! username<br />
|- style="background:yellow"<br />
| 1 || John Smith || johnsmith@domain.example || johnsmith<br />
|- style="background:yellow"<br />
| 2 || Magda Hellman || magda_h@domain.example || magdah<br />
|- style="background:yellow"<br />
| 3 || Yvonne de Gaulle || ydg@domain.example || ydegaulle<br />
|}<br />
<br />
==== loadRowList() ====<br />
<tt>loadRowList()</tt> 从查询返回的表记录返回索引数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadRowList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<br />
<pre>Array ( <br />
[0] => Array ( [0] => 1, [1] => John Smith, [2] => johnsmith@domain.example, [3] => johnsmith ), <br />
[1] => Array ( [0] => 2, [1] => Magda Hellman, [2] => magda_h@domain.example, [3] => magdah ), <br />
[2] => Array ( [0] => 3, [1] => Yvonne de Gaulle, [2] => ydg@domain.example, [3] => ydegaulle ) <br />
)</pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['index'] // e.g. $row['2']['3']</pre><br />
<br />
注释：<br />
# 数组索引是从0开始的数值。<br />
<br />
==== loadAssocList() ====<br />
<tt>loadAssocList()</tt> 从查询返回的表记录返回关联数组的索引数组:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList();<br />
print_r($row);<br />
</source><br />
<br />
将给予(为了清晰起见，添加换行符):<br />
<pre>Array ( <br />
[0] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
) </pre><br />
<br />
您可以通过以下方式访问单个行:<pre>$row['index'] // e.g. $row['2']</pre><br />
你可以通过使用来访问单个值：<pre>$row['index']['column_name'] // e.g. $row['2']['email']</pre><br />
<br />
==== loadAssocList($key) ====<br />
<tt>loadAssocList('key')</tt> returns an associated array - indexed on 'key' - of associated arrays from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => Array ( [id] => 1, [name] => John Smith, [email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => Array ( [id] => 2, [name] => Magda Hellman, [email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => Array ( [id] => 3, [name] => Yvonne de Gaulle, [email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']['column_name'] // e.g. $row['johnsmith']['email']</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadAssocList($key, $column) ====<br />
<tt>loadAssocList('key', 'column')</tt> returns an associative array, indexed on 'key', of values from the column named 'column' returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadAssocList('id', 'username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[1] => John Smith, <br />
[2] => Magda Hellman, <br />
[3] => Yvonne de Gaulle,<br />
)</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
==== loadObjectList() ====<br />
<tt>loadObjectList()</tt> returns an indexed array of PHP objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList();<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[0] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[1] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[2] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['index'] // e.g. $row['2']</pre><br />
and you can access the individual values by using:<pre>$row['index']->name // e.g. $row['2']->email</pre><br />
<br />
==== loadObjectList($key) ====<br />
<tt>loadObjectList('key')</tt> returns an associated array - indexed on 'key' - of objects from the table records returned by the query:<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$row = $db->loadObjectList('username');<br />
print_r($row);<br />
</source><br />
<br />
will give (with line breaks added for clarity):<br />
<pre>Array ( <br />
[johnsmith] => stdClass Object ( [id] => 1, [name] => John Smith, <br />
[email] => johnsmith@domain.example, [username] => johnsmith ), <br />
[magdah] => stdClass Object ( [id] => 2, [name] => Magda Hellman, <br />
[email] => magda_h@domain.example, [username] => magdah ), <br />
[ydegaulle] => stdClass Object ( [id] => 3, [name] => Yvonne de Gaulle, <br />
[email] => ydg@domain.example, [username] => ydegaulle ) <br />
)</pre><br />
<br />
You can access the individual rows by using:<pre>$row['key_value'] // e.g. $row['johnsmith']</pre><br />
and you can access the individual values by using:<pre>$row['key_value']->column_name // e.g. $row['johnsmith']->email</pre><br />
<br />
Note: Key must be a valid column name from the table; it does not have to be an Index or a Primary Key. But if it does not have a unique value you may not be able to retrieve results reliably.<br />
<br />
=== Miscellaneous Result Set Methods ===<br />
==== getNumRows() ====<br />
<tt>getNumRows()</tt> will return the number of result rows found by the last SELECT or SHOW query and waiting to be read. To get a result from getNumRows() you have to run it '''after''' the query and '''before''' you have retrieved any results. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use getAffectedRows().<br />
<br />
<source lang='php'><br />
. . .<br />
$db->setQuery($query);<br />
$db->execute();<br />
$num_rows = $db->getNumRows();<br />
print_r($num_rows);<br />
$result = $db->loadRowList();<br />
</source><br />
<br />
will return <pre>3</pre><br />
Note: getNumRows() is only valid for statements like SELECT or SHOW that return an actual result set. If you run getNumRows() after loadRowList() - or any other retrieval method - you will get a PHP Warning:<br />
<pre>Warning: mysql_num_rows(): 80 is not a valid MySQL result resource <br />
in libraries\joomla\database\database\mysql.php on line 344</pre><br />
<br />
=== See also ===<br />
*[[S:MyLanguage/Inserting, Updating and Removing data using JDatabase|Inserting, Updating and Removing data using JDatabase]]<br />
*[[S:MyLanguage/Using the union methods in database queries|Using the union methods in database queries]] (Joomla! 3.3+)<br />
*[https://api.joomla.org/cms-3/classes/JDatabaseQuery.html Joomla CMS 3.8 API] <br />
<br />
<noinclude><br />
[[Category:Database{{#translation:}}]]<br />
[[Category:JFactory{{#translation:}}]]<br />
[[Category:Extension development{{#translation:}}]]<br />
[[Category:Development Recommended Reading{{#translation:}}]]<br />
[[Category:Tutorials{{#translation:}}]]<br />
</noinclude></div>
Guozhanfeng