Импорт php классов в собственных компонентах Joomla версии 2 и 3

В тех случаях, когда пишется собственный компонент, неотъемлемой его частью будут классы, обслуживающие данный компонент. Для того, чтобы написать что-то вроде mycomponentimport(mycomponent.render.renderjquery) и подключить класс расположенный по адресу "com_mycomponent/libraries/render/renderjquery.php", который затем можно будет использовать как в администраторской части сайта, так и на страницах самого сайта, необходимо добавить в файл компонента(в администраторскую часть сайта /administartor/components/com_mycomponent/mycomponent.php) с его названием mycomponent.php следующий код:

if (! class_exists('MycomponentLoader')) { require_once( JPATH_ADMINISTRATOR.DS.'components'.DS.'com_mycomponent'.DS.'libraries'.DS.'loader.php'); }

С помощью этого кода будет подключен класс (файл должен быть расположн по адресу "components/com_mycomponent/libraries/loader.php") для импорта других классов, код которого указан ниже:

<?php /** * @package Joomla.Framework * @copyright Copyright (C) 2005 - 2010 Open Source Matters, Inc. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE.txt * * @component Yandex map * @copyright Copyright (C) www.slyweb.ru * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License version 2 or later; */ if (!defined('DS')) { define('DS', DIRECTORY_SEPARATOR); } spl_autoload_register(array('JLoader','load')); class MycomponentLoader extends JLoader { private static $paths = array(); protected static $classes = array(); public static function import($filePath, $base = null, $key = 'libraries.') { $keyPath = $key ? $key . $filePath : $filePath; if (!isset($paths[$keyPath])) { if ( !$base ) { $base = JPATH_ADMINISTRATOR.DS.'components'.DS.'com_mycomponent'.DS.'libraries'; } $parts = explode( '.', $filePath ); $className = array_pop( $parts ); switch($className) { case 'helper' : $className = ucfirst(array_pop( $parts )).ucfirst($className); break; Default : $className = ucfirst($className); break; } $path = str_replace( '.', DS, $filePath ); if (strpos($filePath, 'mycomponent') === 0) { $className = 'mycomponent'.$className; $classes = JLoader::register($className, $base.DS.$path.'.php'); $rs = isset($classes[strtolower($className)]); } else { // If it is not in the joomla namespace then we have no idea if // it uses our pattern for class names/files so just include // if the file exists or set it to false if not $filename = $base.DS.$path.'.php'; if (is_file($filename)) { $rs = (bool) include $filename; } else { // if the file doesn't exist fail $rs = false; // note: JLoader::register does an is_file check itself so we don't need it above, we do it here because we // try to load the file directly and it may not exist which could cause php to throw up nasty warning messages // at us so we set it to false here and hope that if the programmer is good enough they'll check the return value // instead of hoping it'll work. remmeber include only fires a warning, so $rs was going to be false with a nasty // warning message } } MycomponentLoader::$paths[$keyPath] = $rs; } return MycomponentLoader::$paths[$keyPath]; } } function mycomponentimport($path) { return MycomponentLoader::import($path); }

Класс "MycomponentLoader" расширяет стандартный класс "JLoader", в результате на страницах компонента возможно подключать классы в стиле Joomla jimport('joomla.application.component.controller');, но вместо jimport соответственно mycomponentimport(mycomponent.render.renderjquery). Будьте внимательны, классы компонента необходимо помещать в директорию libraries, следуя пути "mycomponent.render.renderjquery", в котором точка будет заменена на слэш, имя после завершающей точки будет соответствовать имени файла с расширением php. То есть mycomponentimport(mycomponent.render.renderjquery) подключит файл php, расположенный по адресу "/administrator/components/com_mycomponent/libraries/render/renderjquery.php".

Класс из подключенного файла можно использовать и на страницах сайта, - не только в администраторском разделе, для этого необходимо в файл компонента, расположенный по адресу "/components/com_mycomponent/mycomponent.php" добавить аналогичный код, что и в файл администраторской части:

if (! class_exists('MycmponentLoader')) { require_once( JPATH_ADMINISTRATOR.DS.'components'.DS.'com_mycomponent'.DS.'libraries'.DS.'loader.php'); }

Сейчас классы с помощью данного импорта можно использовать где угодно в рамках компонента "com_mycomponent".

В следующей статье я расскажу о построении алиасов (маршрутиризации) для собственного компонента на сайте с помощью класса JRouter и файла router.php.