2006-05-30 12:42:10 +04:00
|
|
|
<?php
|
2006-12-29 17:01:31 +03:00
|
|
|
/*
|
2006-07-27 21:51:19 +04:00
|
|
|
* $Id$
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*
|
|
|
|
* This software consists of voluntary contributions made by many individuals
|
|
|
|
* and is licensed under the LGPL. For more information, see
|
|
|
|
* <http://www.phpdoctrine.com>.
|
|
|
|
*/
|
|
|
|
/**
|
|
|
|
* Doctrine_Lib has not commonly used static functions, mostly for debugging purposes
|
2006-11-30 00:18:38 +03:00
|
|
|
*
|
|
|
|
* @package Doctrine
|
|
|
|
* @license http://www.opensource.org/licenses/lgpl-license.php LGPL
|
|
|
|
* @category Object Relational Mapping
|
|
|
|
* @link www.phpdoctrine.com
|
|
|
|
* @since 1.0
|
|
|
|
* @version $Revision$
|
|
|
|
* @author Konsta Vesterinen <kvesteri@cc.hut.fi>
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
class Doctrine_Lib
|
|
|
|
{
|
2006-05-30 12:42:10 +04:00
|
|
|
/**
|
|
|
|
* @param integer $state the state of record
|
|
|
|
* @see Doctrine_Record::STATE_* constants
|
|
|
|
* @return string string representation of given state
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getRecordStateAsString($state)
|
|
|
|
{
|
2006-12-29 17:01:31 +03:00
|
|
|
switch ($state) {
|
2007-04-20 00:24:08 +04:00
|
|
|
case Doctrine_Record::STATE_PROXY:
|
|
|
|
return "proxy";
|
|
|
|
break;
|
|
|
|
case Doctrine_Record::STATE_CLEAN:
|
|
|
|
return "persistent clean";
|
|
|
|
break;
|
|
|
|
case Doctrine_Record::STATE_DIRTY:
|
|
|
|
return "persistent dirty";
|
|
|
|
break;
|
|
|
|
case Doctrine_Record::STATE_TDIRTY:
|
|
|
|
return "transient dirty";
|
|
|
|
break;
|
|
|
|
case Doctrine_Record::STATE_TCLEAN:
|
|
|
|
return "transient clean";
|
|
|
|
break;
|
2007-02-17 01:54:59 +03:00
|
|
|
}
|
2006-05-30 12:42:10 +04:00
|
|
|
}
|
|
|
|
/**
|
|
|
|
* returns a string representation of Doctrine_Record object
|
|
|
|
* @param Doctrine_Record $record
|
|
|
|
* @return string
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getRecordAsString(Doctrine_Record $record)
|
|
|
|
{
|
2007-05-16 23:20:55 +04:00
|
|
|
$r[] = '<pre>';
|
|
|
|
$r[] = 'Component : ' . $record->getTable()->getComponentName();
|
|
|
|
$r[] = 'ID : ' . $record->obtainIdentifier();
|
|
|
|
$r[] = 'References : ' . count($record->getReferences());
|
|
|
|
$r[] = 'State : ' . Doctrine_Lib::getRecordStateAsString($record->getState());
|
|
|
|
$r[] = 'OID : ' . $record->getOID();
|
|
|
|
$r[] = 'data : ' . Doctrine::dump($record->getData(), false);
|
|
|
|
$r[] = '</pre>';
|
2006-05-30 12:42:10 +04:00
|
|
|
return implode("\n",$r)."<br />";
|
|
|
|
}
|
2007-04-20 16:42:53 +04:00
|
|
|
/**
|
|
|
|
* Return an collection of records as XML.
|
|
|
|
*
|
|
|
|
* @see getRecordAsXml for options to set in the record class to control this.
|
|
|
|
*
|
|
|
|
* @param Doctrine_Collection $collection
|
|
|
|
* @param SimpleXMLElement $xml
|
|
|
|
* @return string Xml as string
|
|
|
|
*/
|
|
|
|
|
|
|
|
public static function getCollectionAsXml(Doctrine_Collection $collection, SimpleXMLElement $incomming_xml = null){
|
|
|
|
|
2007-05-16 23:20:55 +04:00
|
|
|
$collectionName = Doctrine_Lib::plurelize($collection->getTable()->name);
|
2007-04-20 00:24:08 +04:00
|
|
|
|
2007-05-16 23:20:55 +04:00
|
|
|
if ( ! isset($incomming_xml)) {
|
|
|
|
$xml = new SimpleXMLElement("<" . $collectionName . "></" . $collectionName . ">");
|
2007-04-20 16:42:53 +04:00
|
|
|
} else {
|
2007-05-16 23:20:55 +04:00
|
|
|
$xml = $incomming_xml->addChild($collectionName);
|
2007-04-20 16:42:53 +04:00
|
|
|
}
|
|
|
|
foreach ($collection as $key => $record) {
|
|
|
|
Doctrine_Lib::getRecordAsXml($record, $xml);
|
|
|
|
}
|
|
|
|
return $xml->asXML();
|
|
|
|
}
|
|
|
|
|
|
|
|
public static function plurelize($string){
|
|
|
|
return $string . "s";
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return a recrd as XML.
|
|
|
|
*
|
|
|
|
* In order to control how this is done set the "xml" option in a record.
|
|
|
|
* This option is an array that has the keys "ignore_fields" and "include_relations". Both of these are arrays that list the name of fields/relations to include/process.
|
|
|
|
*
|
|
|
|
* If you want to insert this xml as a part inside another xml send a
|
|
|
|
* SimpleXMLElement to the function. Because of the nature of SimpleXML the
|
|
|
|
* content you add to this element will be avilable after the function is
|
|
|
|
* complete.
|
|
|
|
*
|
|
|
|
* @param Doctrine_Record $record
|
|
|
|
* @param SimpleXMLElement $xml
|
|
|
|
* @return string Xml as string
|
|
|
|
*/
|
|
|
|
public static function getRecordAsXml(Doctrine_Record $record, SimpleXMlElement $incomming_xml = NULL)
|
2007-04-20 00:24:08 +04:00
|
|
|
{
|
|
|
|
$recordname = $record->getTable()->name;
|
2007-04-20 16:42:53 +04:00
|
|
|
if (!isset($incomming_xml)) {
|
2007-04-20 00:24:08 +04:00
|
|
|
$xml = new SimpleXMLElement("<" . $recordname . "></" . $recordname . ">");
|
2007-04-20 16:42:53 +04:00
|
|
|
}else{
|
|
|
|
$xml = $incomming_xml->addChild($recordname);
|
2007-04-20 00:24:08 +04:00
|
|
|
}
|
2007-04-20 16:42:53 +04:00
|
|
|
foreach($record->obtainIdentifier() as $pk_field => $pk_value){
|
|
|
|
$xml->addChild($pk_field,$pk_value);
|
|
|
|
}
|
2007-04-20 00:24:08 +04:00
|
|
|
$xml_options = $record->option("xml");
|
|
|
|
foreach ($record->getData() as $field => $value) {
|
|
|
|
if (isset($xml_options["ignore_fields"]) && !in_array($field, $xml_options["ignore_fields"])) {
|
2007-04-20 16:42:53 +04:00
|
|
|
if ($value instanceOf Doctrine_Null) {
|
|
|
|
$xml->addChild($field);
|
|
|
|
} else {
|
|
|
|
$xml->addChild($field, $value);
|
|
|
|
}
|
2007-04-20 00:24:08 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
if (!isset($xml_options["include_relations"])) {
|
|
|
|
return $xml->asXML();
|
|
|
|
}
|
|
|
|
$relations = $record->getTable()->getRelations();
|
|
|
|
foreach ($relations as $name => $relation) {
|
|
|
|
if (in_array($name, $xml_options["include_relations"])) {
|
|
|
|
$relation_type = $relation->getType();
|
|
|
|
$related_records = $record->get($name);
|
2007-04-20 16:42:53 +04:00
|
|
|
if ($relation_type == Doctrine_Relation::ONE && $related_records instanceOf Doctrine_Record) {
|
|
|
|
Doctrine_Lib::getRecordAsXml($related_records, $xml);
|
2007-04-20 00:24:08 +04:00
|
|
|
} else {
|
2007-04-20 16:42:53 +04:00
|
|
|
Doctrine_Lib::getCollectionAsXml($related_records, $xml);
|
2007-04-20 00:24:08 +04:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $xml->asXML();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
2006-05-30 12:42:10 +04:00
|
|
|
/**
|
|
|
|
* getStateAsString
|
2006-08-22 03:19:15 +04:00
|
|
|
* returns a given connection state as string
|
|
|
|
* @param integer $state connection state
|
2006-05-30 12:42:10 +04:00
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getConnectionStateAsString($state)
|
|
|
|
{
|
2006-12-29 17:01:31 +03:00
|
|
|
switch ($state) {
|
2007-04-20 00:24:08 +04:00
|
|
|
case Doctrine_Transaction::STATE_SLEEP:
|
|
|
|
return "open";
|
|
|
|
break;
|
|
|
|
case Doctrine_Transaction::STATE_BUSY:
|
|
|
|
return "busy";
|
|
|
|
break;
|
|
|
|
case Doctrine_Transaction::STATE_ACTIVE:
|
|
|
|
return "active";
|
|
|
|
break;
|
2007-02-17 01:54:59 +03:00
|
|
|
}
|
2006-05-30 12:42:10 +04:00
|
|
|
}
|
|
|
|
/**
|
2006-08-22 03:19:15 +04:00
|
|
|
* returns a string representation of Doctrine_Connection object
|
|
|
|
* @param Doctrine_Connection $connection
|
2006-05-30 12:42:10 +04:00
|
|
|
* @return string
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getConnectionAsString(Doctrine_Connection $connection)
|
|
|
|
{
|
2007-02-17 01:54:59 +03:00
|
|
|
$r[] = '<pre>';
|
|
|
|
$r[] = 'Doctrine_Connection object';
|
|
|
|
$r[] = 'State : ' . Doctrine_Lib::getConnectionStateAsString($connection->transaction->getState());
|
|
|
|
$r[] = 'Open Transactions : ' . $connection->transaction->getTransactionLevel();
|
|
|
|
$r[] = 'Table in memory : ' . $connection->count();
|
|
|
|
$r[] = 'Driver name : ' . $connection->getDbh()->getAttribute(Doctrine::ATTR_DRIVER_NAME);
|
2006-05-30 12:42:10 +04:00
|
|
|
|
|
|
|
$r[] = "</pre>";
|
|
|
|
return implode("\n",$r)."<br>";
|
|
|
|
}
|
|
|
|
/**
|
|
|
|
* returns a string representation of Doctrine_Table object
|
|
|
|
* @param Doctrine_Table $table
|
|
|
|
* @return string
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getTableAsString(Doctrine_Table $table)
|
|
|
|
{
|
2006-05-30 12:42:10 +04:00
|
|
|
$r[] = "<pre>";
|
2006-06-25 22:34:53 +04:00
|
|
|
$r[] = "Component : ".$table->getComponentName();
|
|
|
|
$r[] = "Table : ".$table->getTableName();
|
2006-05-30 12:42:10 +04:00
|
|
|
$r[] = "</pre>";
|
|
|
|
return implode("\n",$r)."<br>";
|
|
|
|
}
|
2006-06-09 02:11:36 +04:00
|
|
|
/**
|
|
|
|
* @return string
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function formatSql($sql)
|
|
|
|
{
|
2006-06-09 02:11:36 +04:00
|
|
|
$e = explode("\n",$sql);
|
|
|
|
$color = "367FAC";
|
|
|
|
$l = $sql;
|
2006-12-28 14:56:24 +03:00
|
|
|
$l = str_replace("SELECT ", "<font color='$color'><b>SELECT </b></font><br \> ",$l);
|
|
|
|
$l = str_replace("FROM ", "<font color='$color'><b>FROM </b></font><br \>",$l);
|
|
|
|
$l = str_replace(" LEFT JOIN ", "<br \><font color='$color'><b> LEFT JOIN </b></font>",$l);
|
|
|
|
$l = str_replace(" INNER JOIN ", "<br \><font color='$color'><b> INNER JOIN </b></font>",$l);
|
|
|
|
$l = str_replace(" WHERE ", "<br \><font color='$color'><b> WHERE </b></font>",$l);
|
|
|
|
$l = str_replace(" GROUP BY ", "<br \><font color='$color'><b> GROUP BY </b></font>",$l);
|
|
|
|
$l = str_replace(" HAVING ", "<br \><font color='$color'><b> HAVING </b></font>",$l);
|
|
|
|
$l = str_replace(" AS ", "<font color='$color'><b> AS </b></font><br \> ",$l);
|
|
|
|
$l = str_replace(" ON ", "<font color='$color'><b> ON </b></font>",$l);
|
|
|
|
$l = str_replace(" ORDER BY ", "<font color='$color'><b> ORDER BY </b></font><br \>",$l);
|
|
|
|
$l = str_replace(" LIMIT ", "<font color='$color'><b> LIMIT </b></font><br \>",$l);
|
|
|
|
$l = str_replace(" OFFSET ", "<font color='$color'><b> OFFSET </b></font><br \>",$l);
|
|
|
|
$l = str_replace(" ", "<dd>",$l);
|
2006-12-29 17:01:31 +03:00
|
|
|
|
2006-06-09 02:11:36 +04:00
|
|
|
return $l;
|
|
|
|
}
|
2006-05-30 12:42:10 +04:00
|
|
|
/**
|
|
|
|
* returns a string representation of Doctrine_Collection object
|
|
|
|
* @param Doctrine_Collection $collection
|
|
|
|
* @return string
|
|
|
|
*/
|
2006-12-29 17:40:47 +03:00
|
|
|
public static function getCollectionAsString(Doctrine_Collection $collection)
|
|
|
|
{
|
2006-05-30 12:42:10 +04:00
|
|
|
$r[] = "<pre>";
|
|
|
|
$r[] = get_class($collection);
|
|
|
|
|
2006-12-29 17:01:31 +03:00
|
|
|
foreach ($collection as $key => $record) {
|
2006-09-17 21:59:04 +04:00
|
|
|
$r[] = "Key : ".$key." ID : ".$record->obtainIdentifier();
|
2006-05-30 12:42:10 +04:00
|
|
|
}
|
|
|
|
$r[] = "</pre>";
|
|
|
|
return implode("\n",$r);
|
|
|
|
}
|
|
|
|
}
|