Документация для специалистов

Эксперименты и исследования

Подгрузка "классных" процессоров средствами API MODX

addPackage vs loadClass vs getService вчём правда брат?

Честно признаться использовал метод loadClass, но только совместно с методом setPackage, а вот про addExtensionPackage услышал впервые.
 В очередной раз спасибо за новую информацию.

Честно признаться использовал метод loadClass, но 

Пожалуйста.
 Я про это еще здесь писал: community.modx-cms.ru/blog/documentation/9226.html

Пожалуйста.
 Я про это еще здесь писал: community.

Да как только увидел её здесь и всемогущий google помог мне отыскать статью в которой и был он описан, сейчас знакомлюсь)

Да как только увидел её здесь и всемогущий google 

Топик дополнил новым материалом.

Кстати, есть второй способ прописать пакет, чтобы он подключался при инициализации MODx (по идее это тот же способ, только ручками): заходим в настройки системы, раздел «Система и сервер» и находим там параметр «Пакеты расширений» (extension_packages). Если мы до этого хоть раз запускали addExtensionPackage(), то в его значении уже будут все параметры в JSON — их можно исправить, что-нибудь добавить к ним… Если addExtensionPackage() не запускали, то можно там прописать ручками:
 

(конечно, в одну строчку)
 

Для разных нужных методов, которые используются в разных местах я создал отдельный класс Rehab (в папке пакета) и в нем прописываю функционал. Благодаря этому я в любом месте могу написать
 

и массив обработается с нужными проверками, дефолтными значениями. И результат будет каким надо. Если потребуется изменить алгоритм обработки телефонов, я всегда знаю, где искать этот код.
 

А вот пути для процессоров прописывать приходится, конечно… Надо попробовать добавить в extension_packages строчку и для процессоров. Тогда вообще не придется задумываться, что у меня какие-то левые объекты или процессоры — весь код будет стандартным))))

Кстати, есть второй способ прописать пакет, чтобы он подключался при инициализации MODx (по идее это тот же способ, только ручками): заходим в настройки системы, раздел «Система и сервер» и находим там параметр «Пакеты расширений» (extension_packages). Если мы до этого хоть раз запускали addExtensionPackage(), то в его значении уже будут все параметры в JSON — их можно исправить, что-нибудь добавить к ним… Если addExtensionPackage() не запускали, то можно там прописать ручками: [{"Rehab":
  {
   "path":"[[++core_path]]components/rehab/model/",
   "tablePrefix":"modx_rehab_",
   "serviceName":"Rehab",
   "serviceClass":"Rehab"
  }
}] (конечно, в одну строчку) Для разных нужных методов, которые используются в разных местах я создал отдельный класс Rehab (в папке пакета) и в нем прописываю функционал. Благодаря этому я в любом месте могу написать $modx->Rehab->phonesToJSON($phones); и массив обработается с нужными проверками, дефолтными значениями. И результат будет каким надо. Если потребуется изменить алгоритм обработки телефонов, я всегда знаю, где искать этот код. А вот пути для процессоров прописывать приходится, конечно… Надо попробовать добавить в extension_packages строчку и для процессоров. Тогда вообще не придется задумываться, что у меня какие-то левые объекты или процессоры — весь код будет стандартным))))

Кстати, есть второй способ прописать пакет, чтобы 

Привет, Илья! 
 Да, результат addExtensionPackacge() — это как раз запись в эту настройку. Так что и так, и так можно.
 

Надо попробовать добавить в extension_packages строчку и для процессоров. Тогда вообще не придется задумываться, что у меня какие-то левые объекты или процессоры — весь код будет стандартным)))) 

Не получится здесь одной строчкой обойтись. Задача того, что я делал — возможность подгружать любой процессор из любого пакета, при чем с автоформированием пути. Там слишком много тонкостей. Плюс мой метод возвращает реальное имя класса (сам знаешь, в процессорах используется return 'classname';) Все это никак не укладывается в одну строчку. Еще момент — ты вот своим методом подгрузишь мой процессор, а у меня там используется $this->loadClass(), а у тебя $this будет другим объектом. И все, код разваливается. 
 Здесь любое решение будет костылями (и лучше использовать одни костыли). Решить это можно только тогда, когда Джейсон новый релиз выпустит, учитывающий все эти моменты. Мы вчера с ним основательно пообщались на этот счет. Уверен, он и других людей мнение учитывает, так что будет стандартное решение.

Привет, Илья! 
 Да, результат addExtensionPackacge() — это как раз запись в эту настройку. Так что и так, и так можно. Надо попробовать добавить в extension_packages строчку и для процессоров. Тогда вообще не придется задумываться, что у меня какие-то левые объекты или процессоры — весь код будет стандартным)))) Не получится здесь одной строчкой обойтись. Задача того, что я делал — возможность подгружать любой процессор из любого пакета, при чем с автоформированием пути. Там слишком много тонкостей. Плюс мой метод возвращает реальное имя класса (сам знаешь, в процессорах используется return 'classname';) Все это никак не укладывается в одну строчку. Еще момент — ты вот своим методом подгрузишь мой процессор, а у меня там используется $this->loadClass(), а у тебя $this будет другим объектом. И все, код разваливается. 
 Здесь любое решение будет костылями (и лучше использовать одни костыли). Решить это можно только тогда, когда Джейсон новый релиз выпустит, учитывающий все эти моменты. Мы вчера с ним основательно пообщались на этот счет. Уверен, он и других людей мнение учитывает, так что будет стандартное решение.

Привет, Илья! 
 Да, результат addExtensionPackacge

Если такая возможность появится штатно, будет очень здорово! Как всегда, Спасибо тебе за статью!

Если такая возможность появится штатно, будет очен

Пожалуйста:-)

На деюсь я в правильном топике написал? )))

Два раза в код обарачивает. Я чтото не так сделал? Я писал так 

Два раза в код обарачивает. Я чтото не так сделал? Я писал так /code>

Два раза в код обарачивает. Я чтото не так сделал?

в коментариях нормально вроде ))))

$path = MODX_CORE_PATH . 'components/mycomponent/model/';

$modx->loadClass('myclass.MyClass', $path, true, true);

Лучше все это заменить на 
 

$modx->loadClass('myclass.MyClass', '', false, true);

В таком случае нам не надо указывать четкий путь к директории, а третий параметр false указывает на то, что надо искать во всех подключенных пакетах. Но это в случае, если пакет подключен. Твой пример годится в тех случаях, когда пакет не подключен, а класс подключить надо.

$path = MODX_CORE_PATH . 'components/mycomponent/model/';

$modx->loadClass('myclass.MyClass', $path, true, true); Лучше все это заменить на $modx->loadClass('myclass.MyClass', '', false, true); В таком случае нам не надо указывать четкий путь к директории, а третий параметр false указывает на то, что надо искать во всех подключенных пакетах. Но это в случае, если пакет подключен. Твой пример годится в тех случаях, когда пакет не подключен, а класс подключить надо.

$path = MODX_CORE_PATH . 'components/mycomponent/m

Коды не всегда корректно обрабатываются. Типографику подключать надо будет. Это чуть позже.

Коды не всегда корректно обрабатываются. Типографи

А вообще здесь какой-то вопрос стоял или нет? Лично я всегда пакеты расширяющие подключаю сразу. Прирост нагрузки ничтожный, а удобств - масса.

А вообще здесь какой-то вопрос стоял или нет? Личн

То есть  addExtensionPackage вполне нормально использовать? Вопрос стоял у меня и я просто исча на них точные ответы написал статью. Как то так ))))

То есть  addExtensionPackage вполне нормально испо

addExtensionPackage очень даже нормально использовать.

addExtensionPackage очень даже нормально использов

Кстати, еще раз перечитал заголовок, и усматриваю довольно серьезное непонимание вещей. Ты сравниваешь вообще разные механизмы. Давай по порядку:


1. xPDO::loadClass() - это метод для подгрузки классов, при чем без разницы каких, xPDO-классов или нет. 
 Рассмотрим на примере: если нам нужно создать новый объект, к примеру $modx->newObject('modUser'), то для этого нам нужен класс modUser, то есть его надо подгрузить. Так вот, xPDO::loadClass($className) этим и занимается, и он автоматически вызывается внутри метода newObject() (как и других похожих методов, типа getObject(), getCollection() и т.п.).


2. xPDO::addPackage() нужен для того, чтобы подключить еще один пакет с классами, то есть еще одну директорию (как правило это директория модуля). Когда пакет подключен, то xPDO::loadClass() ищет во всех подключенных модулях, пока не найдет запрошенный класс (если, как писалось выше, третий параметр не установлен в значение true).


3. xPDO::addExtensionPackage() - это просто автоматическое подключение addPackage(), просто для удобства и автоматизации.


4. xPDO::getService() - вот это совсем другая песня. Для нее справедливо и все то, что перечислено выше (так как тоже используется метод loadClass(), и addPackage()(если надо, само собой еще до вызова метода getService())), но этот метод используется для расширения самого объекта $modx. К примеру, $modx->getService($alias, $class); В случае успеха будет доступен объект $modx->$alias, к примеру $modx->mail или $modx->error. И это совсем не для xPDO-классов.


Кстати, еще раз перечитал заголовок, и усматриваю довольно серьезное непонимание вещей. Ты сравниваешь вообще разные механизмы. Давай по порядку: 1. xPDO::loadClass() - это метод для подгрузки классов, при чем без разницы каких, xPDO-классов или нет. 
 Рассмотрим на примере: если нам нужно создать новый объект, к примеру $modx->newObject('modUser'), то для этого нам нужен класс modUser, то есть его надо подгрузить. Так вот, xPDO::loadClass($className) этим и занимается, и он автоматически вызывается внутри метода newObject() (как и других похожих методов, типа getObject(), getCollection() и т.п.). 2. xPDO::addPackage() нужен для того, чтобы подключить еще один пакет с классами, то есть еще одну директорию (как правило это директория модуля). Когда пакет подключен, то xPDO::loadClass() ищет во всех подключенных модулях, пока не найдет запрошенный класс (если, как писалось выше, третий параметр не установлен в значение true). 3. xPDO::addExtensionPackage() - это просто автоматическое подключение addPackage(), просто для удобства и автоматизации. 4. xPDO::getService() - вот это совсем другая песня. Для нее справедливо и все то, что перечислено выше (так как тоже используется метод loadClass(), и addPackage()(если надо, само собой еще до вызова метода getService())), но этот метод используется для расширения самого объекта $modx. К примеру, $modx->getService($alias, $class); В случае успеха будет доступен объект $modx->$alias, к примеру $modx->mail или $modx->error. И это совсем не для xPDO-классов. Так понятней?

Кстати, еще раз перечитал заголовок, и усматриваю 

Да спасибо так понятней ))

Пожалуйста :)

Есть вопрос который поледнее время мучает мне на нравится как робатется с TV через xPDO да и вобще это прокол MODX. Пытаюсь копенсировать MIGXdb или создавать класс который наследует modResource. Потомучто для магаза или ещё чего не удобно по TV сортировать. Попробовал ClassExtender но помойму туповато. Мог бы поделится как решать проблему. Спасибо.

Есть вопрос который поледнее время мучает мне на н

Как по мне то MIGXdb нормальный вариант в целом

Вот здесь писал про наши методы поиска и сортировки.

Вот здесь писал про наши методы поиска и сортировк

Хорошо спасибо пора прокачиваться до процессоров )))))

Хорошо спасибо пора прокачиваться до процессоров )

Давно пора.

БлагоДарю, Николай! Вы, как всегда выручаете меня. Не знал, как подключить в свой компонент классы стороннего компонента. addPackage пришёл на помощь благодаря Вам.

БлагоДарю, Николай! Вы, как всегда выручаете меня.

Всегда пожалуйста :)

Подскажите, пожалуйста, как использовать в сниппете кастомный класс?

Сейчас подключаю через  $modx->loadClass, но возникла проблема - если запускать данный сниппет из другого сниппета методом $modx->runSnippet - то кастомный класс не виден и получаю ошибку. 

Подскажите, пожалуйста, как использовать в сниппете кастомный класс? Сейчас подключаю через  $modx->loadClass, но возникла проблема - если запускать данный сниппет из другого сниппета методом $modx->runSnippet - то кастомный класс не виден и получаю ошибку.

Подскажите, пожалуйста, как использовать в сниппет

Вы что-то недоговариваете. Если у вас в сниппете это работает, и вы вызываете этот сниппет внутри другого сниппета через $modx->runSnippt() напрямую (а не через другие чанки и т.п.), то все должно нормально работать. Может вы что-то не так вызываете? Или не то пытаетесь вернуть? Приведите коды своих сниппетов (можно частично, только те места, где вызовы происходят).

Вы что-то недоговариваете. Если у вас в сниппете э


$modx->loadClass('myclass', $modx->getOption('assets_path') . 'plugins/g/', true, true); 
$myObj = new myClass();
$result = $myObj->make($resource_id);
return $result;


В консоле
$resource_id = 1;
echo $modx->runSnippet('getF',['resource_id'=>$resource_id]);

Сниппет 1 "getF"

Самое интересное что если в 1 сниппете перед return завершить - die( $result ) -  то результат в консоле есть. 

Самое интересное что если в 1 сниппете перед retur

А какой тип данных возвращает $myObj->make($resource_id); ?

А какой тип данных возвращает $myObj->make($resour

И еще непонятная вещь - не срабатывает только первый вызов  $modx->runSnippet('getF',['resource_id'=>$resource_id]);  а последующие срабатывают (возвращают значение). миркл

И еще непонятная вещь - не срабатывает только перв

Должен возвращать строку. А возвращает пустую строку. 

Должен возвращать строку. А возвращает пустую стро

Странно тогда... Вы точно в результате возвращаете не MODX-тег (типа плейсхолдера или типа того)? Пришлите мне на почту n.lanets@modxclub.ru доступ на сайт, я посмотрю что у вас там не так.

Странно тогда... Вы точно в результате возвращаете

Спасибо за помощь, подготовлю тестовый доступ - напишу вам на почту.

Спасибо за помощь, подготовлю тестовый доступ - на

Не за что еще.

addPackage

getService

loadClass

modx

modx revolution

xPDO

процессоры

# Николай Ланец aka Fi1osof
**Lead Fullstack Developer / Ментор / Евангелист современного JS‑стека**

---

## О себе

Я — не просто Senior Developer с 2007 года. Я — тот, кто строит продукты будущего на базе современных технологий и помогает другим подниматься на новую ступень айти-карьеры. Создатель и идейный вдохновитель freecode.academy — платформы, где обучение перестает быть скучной обязаловкой и становится настоящим технологическим приключением.

---

## Мой стек и философия разработки

Основу моего рабочего арсенала составляют:

- [Javascript](/technologies/ck1faudv928l40a89c4u9zxlm), [TypeScript](/technologies/ckcvwwx010kov08009u7y2rav)
- [React](/technologies/ck1fawbdw28v20a891k4wlh27), [Next.js](/technologies/ckg2jd4ffr9260730aog66dri)
- [Node.js](/technologies/ckt55wm59272831wo9gg9r8ynx), [GraphQL](/technologies/ck1fawhqk28vu0a8995lqvlsj), [Apollo Client](/technologies/ck2zdcg0vpvc10a89xjmhj1e0), [Nexus](/technologies/ckl2pbh0fxew60730ifl3zozp), [Prisma](/technologies/ck2zdbmi7pv8r0a89ntc2r0f1)
- DevOps: [Docker](/technologies/ck2y1x9lho9cy0a8953xzfjr8), [docker-compose](/technologies/ck2y1xqino9g80a89tsftxin2), [Caddy](/technologies/ck2zd8ovqpuyl0a8909748sbu), [Ubuntu](/technologies/cktu8giks3593911vmle30ztqxt)
- UI-инструменты: [Styled-Components](/technologies/ckk8myysio7lw0730csszvrdw), [Material-UI](/technologies/ckljv3jwd7bgf0730huxlko9n), [react-hook-form](/technologies/ckmx8cn9fmwrv073032e67722)
- Всё актуальное для разработки, CI/CD и автоматизации 
- Эксперименты с [WebGL](/technologies/ckan9anntc12f08003saqttrq), [A‑Frame](/technologies/ck2tgoiz8j37y0a89c7gxsrxc), [Three.js](/technologies/ck2tgns1nj32z0a89vmw7xw3f), [Unreal Engine 4](/technologies/ck7puswy6g4yb07004cdp6lbr), [Elixir](/technologies/ckn0olavrnnzi0730xs8rctn8), [C++](/technologies/cknin1y8lu2fr07307mskn2fn)

---

## Разработка и менторство

- Более 15 лет **hands-on** разработки и проджект‑менеджмента
- Главный разработчик и преподаватель платформы [freecode.academy](https://freecode.academy)
- **Ведущий менти-пул на платформе** — лично выращиваю новых звезд отрасли

### Мои менти и их результаты

| Менти (ФИО \| username)                               | Уровень | Рейтинг |
|-------------------------------------------------------|---------|---------|
| [Попов Дмитрий \| linklib](/users/cjoe890c706ji0d962oismzoe)           | 3       | 315     |
| [Сэт \| defk1lla](/users/ckzh1ita312978121imr9hpqfc64)                 | 3       | 670     |
| [Ксения Матвеева \| Ксения Матвеева](/users/ckz4awwlh10627771imr4wvpb7cj) | 2       | 0       |
| [Михаил \| Balamut](/users/cl1npq92z10258261vmbq0w6vfh2)               | 2       | 0       |
| [Ольга Ершова \| angel](/users/cjoe87zhk00250d969arluevk)              | 1       | 0       |
| [Егор \| rogedkone](/users/cksrdp47d3308261ijuq7wfrxdl)                | 3       | 0       |
| [Roman \| Roman43](/users/ckur2qtt64721431xoboyjcte52)                 | 2       | 0       |
| [Бут Игорь \| santiment](/users/ckttd9x20893951vmltb8t7sha)            | 1       | 0       |

**Доношу простую мысль: успех — это не магия, это осознанная системная работа и кайф от роста.**
Мои менти выводят решения в продакшн, пробиваются в лидеры рейтингов — кому не хочется быть в такой команде?

---

## Почему я?

- **Прокачаю проект** — от TDD архитектуры до культурного CI/CD
- **Вдохновлю команду** — и научу мыслить по‑новому, где ИИ — напарник, а не угроза
- **Выращу мидлов и сеньоров** — доказано платформой и рейтингами моих учеников

**Сила — в сообществе, а техника — это просто смазка для ваших побед. Присоединяйтесь!**

---

## Контакты

- 📧 [n.lanets@freecode.academy](mailto:n.lanets@freecode.academy)
- Телеграм: [@freecode_academy](https://t.me/freecode_academy)

---

**P.S.**: Мой опыт — ваш драйвер роста. Хотите в команду? Ищете менторство? Пишите. Растём вместе!