Joomla:$ tableClass定义在哪里,JTable:getInstance返回什么?

时间:2015-08-19 23:09:14

标签: php joomla k2

我对joomla核心和PHP知之甚少。为了更好地处理我的网站,我试图阅读joomla核心的一小部分,当我遇到这个函数JTable:getInstance,(libararies \ joomla \ table \ table.php line268)时,它返回

    return new $tableClass($db);

要了解getInstance返回的内容,我需要知道这个$tableClass是如何定义的,所以我在我网站的所有php文件中搜索了它,虽然有很多参考文献,甚至有些参考文献 - 被称为'定义'的this page指出,它们都不是我想要的。我期待像

这样的东西
class tableClass{...}

此外,从其他php文件中,有以下几行:

$row = JTable::getInstance('K2Item', 'Table');
$row->hit($id);

所以在我看来,getInstance返回的内容应该是一个拥有成员hit()的对象,所以我期待像

这样的东西
class tableClass{...
    function hit(){
    .....
    }
}

但是这种代码无处可寻,所以我被困在这里并且肯定需要帮助。

我的一些想法:$ tableClass真的是一个类吗?我注意到它有一个$,其他所有类都没有?如果它不是一个类,那么为什么可以像new $tableClass一样调用它?我真的需要了解这些基础知识,但谷歌关键字$很难。

1 个答案:

答案 0 :(得分:0)

下面粘贴了完整的方法。调用JTable :: getInstance时,必须传递$ type作为参数。然后getInstance方法使用$ type来定义$ tableClass,如下所示。

// Sanitize and prepare the table class name.
$type       = preg_replace('/[^A-Z0-9_\.-]/i', '', $type);
$tableClass = $prefix . ucfirst($type);

然后该方法继续加载(导入)该类(如果它还没有),然后最终调用返回new $ tableClass($ db);

所以$ tableClass只是一个基于$ type参数的动态变量。

在上面的示例中:

$row = JTable::getInstance('K2Item', 'Table');

$ type和$ prefix参数转换为以下内容:

返回新的TableK2Item($ db);

因此,如果您搜索TableK2Item,您确实应该找到具有hit()方法的类。

所以$ tableClass实际上是在getInstance方法中定义的。

这有意义吗?

/**
 * Static method to get an instance of a JTable class if it can be found in
 * the table include paths.  To add include paths for searching for JTable
 * classes see JTable::addIncludePath().
 *
 * @param   string  $type    The type (name) of the JTable class to get an instance of.
 * @param   string  $prefix  An optional prefix for the table class name.
 * @param   array   $config  An optional array of configuration values for the JTable object.
 *
 * @return  mixed    A JTable object if found or boolean false if one could not be found.
 *
 * @link    https://docs.joomla.org/JTable/getInstance
 * @since   11.1
 */
public static function getInstance($type, $prefix = 'JTable', $config = array())
{
    // Sanitize and prepare the table class name.
    $type       = preg_replace('/[^A-Z0-9_\.-]/i', '', $type);
    $tableClass = $prefix . ucfirst($type);

    // Only try to load the class if it doesn't already exist.
    if (!class_exists($tableClass))
    {
        // Search for the class file in the JTable include paths.
        jimport('joomla.filesystem.path');

        $paths = self::addIncludePath();
        $pathIndex = 0;

        while (!class_exists($tableClass) && $pathIndex < count($paths))
        {
            if ($tryThis = JPath::find($paths[$pathIndex++], strtolower($type) . '.php'))
            {
                // Import the class file.
                include_once $tryThis;
            }
        }

        if (!class_exists($tableClass))
        {
            // If we were unable to find the class file in the JTable include paths, raise a warning and return false.
            JLog::add(JText::sprintf('JLIB_DATABASE_ERROR_NOT_SUPPORTED_FILE_NOT_FOUND', $type), JLog::WARNING, 'jerror');

            return false;
        }
    }

    // If a database object was passed in the configuration array use it, otherwise get the global one from JFactory.
    $db = isset($config['dbo']) ? $config['dbo'] : JFactory::getDbo();

    // Instantiate a new table class and return it.
    return new $tableClass($db);
}