Каким способом изучать API Битрикса?

Question

[Arris1]

Добрый день!

При изучении Битрикса по официальной документации на уровне Администратор никаких сложностей не возникает - все понятно.
Но при изучении API для разработчиков столкнулся с нехваткой информации, даже о простых вещах вроде массивов шаблонов компонентов и инфоблоков $ArResutlt, $ArItem, $ArFiles и подобных.

Например не нашел:

1 списка подобных массивов с их назначением
2 перечесления их возможных полей (например LINK, TEXT)
3 описания их формировния

Делал поиск по документации - нашлось несколько обрывочных текстов в разных разделах, общего плана без ответа на пункты выше.

Тоже самое и с функциями Битрикс - есть большой справочник где все в кучу, со скупыми описаниями, взаимосвязи между ними вообще не вижу.

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

Я новичок в изучении программирования, может быть не понимаю чего то? и такое просто не документируется?
Может такие вещи разбираются самостоятельно с использованием средств php (типа вывода содержимого массива)?
Все функции вручную тестируются или как?

Comments

[Stalker_RED]

Просто документация битрикса - УГ.

Answer 1

[Андрей Николаев]

Добрый день,

Давайте начнем с того, что названия переменных значения не играют. Т.е. Вы можете поменять в коде местами $arSelect и $arFilter и результат от этого не изменится (если Вы все сделали правильно). Что касается их названий - они помогают лично Вам понять что в них находятся и работают по принципу венгерской нотации, с типами и camelCase. То есть в переменной $arFilter находится массив полей, по которому производится фильтрация, а в $arSelect - массив полей, который нужно получить.

Что касается документации - вранье, она обширная и разжевана до мелочей. Если Вы хотите получить план по развитию, то:
1) Пройдите всю цепочку битрикса от "Контент-менеджера" до "Администратора" (все 3) и поймите как это работает в админке
2) Пройдите курс Bitrix Framework и поймите как с этим работать с точки зрения разработчика
3) Активно читайте справочную литературу - https://dev.1c-bitrix.ru/api_help/ и https://dev.1c-bitrix.ru/api_d7/
4) Смотрите на официальные курсы по битриксу https://academy.1c-bitrix.ru/training/course/
5) Сдавайте официальные экзамены (там примеры заданий и четкие решения) https://academy.1c-bitrix.ru/certification/exams.php

Я Вас уверяю, при сдаче и первого и второго экзамена, Вы уже будете понимать все что нужно для уровня Junior-Middle

Comments

[Евгений]

Полностью поддерживаю пункты 1-5

Про разжеванную и подробную документацию - не полностью поддерживаю) Для типовых задач там всё есть. Для каких-то нестандартных приходится сходить в ядро и посмотреть как работает та или иная функция.

[Андрей Николаев]

Евгений: это нормальное состояние для разрозненных команд. Все простое там разжевано до мелочей, и покрывает 80% необходимого. Да, для каких-то специальных или сложных вещей ее нет, но это потому что либо кейс слишком редкий, либо нет явного трактования.
И да, мое изречение относится только к БУС, по Б24 вообще лютая адь, т.е. только ядро, только заметки других разработчиков

[Arris1]

Ну вот смотрите, например, для компонента детальной новости news-detail
используются массивы $arParams, $arResult и поля FIELDS, DISPLAY_TOP_PAGER, NAV_RESULT

1.в этом компоненте используются только эти массивы или какие то еще? как посмотреть?
2. как посмотреть все поля доступные в массивах и где эти поля формируются? в файле parametrs?
3. необходимые поля в массив можно добавлять самому?

[Андрей Николаев]

Arris1: если бы Вы прошли обучение, то вопросов 1-3 просто не возникло бы.
Ответ на первый вопрос, подробно поясняет схема работы компонента, которую можно найти в блоге Ивана Малышина, ко 2 экзамену: https://dev.1c-bitrix.ru/community/blogs/dev_bx/a-...

В ходе работы используются 2 массива - arParams (массив параметров переданных компоненту и/или полученных в ходе работы компонента) и arResult - результат работы компонента (т.е. то что было сделано в ходе работы компонента). Оба массива могут быть дополнены как в class.php, result_modifier.php так и в component.php
Что касается содержимого данных массивов оно зависит от самого компонента и традиционно формируются в component.php (старый подход) и/или class.php (новый подход).

Вот собственно ответы на все Ваши вопросы.

[Arris1]

Спасибо за ответ, дело в том, блогов очень много и найти нужный сложно, буду изучать)

[Андрей Николаев]

Arris1: не за что. Если это ответ - отметьте его решением

Answer 2

[Илья]

Берите типовую задачу и делайте.
Не типовое решение (хотя тоже как вариант), а с нуля начинайте разбираться в задаче.
Если вы будете на основе чего-то разбираться (типового решения), то знания у вас будут только на основе данного решения.
Если вы с нуля будете разбираться, то думать придется и разберетесь вы в задаче (интернет-магазин), а не в инструменте (типовое решение).

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

Comments

[Arris1]

А чем решение у вас отличается от задачи?

[Илья]

Arris1: решение - это уже что-то готовое, т.е. человек сам не думает, а смотрит на примере.
задача - это просто постановка проблемы (задачи) и ее надо "как-то" решить, и вот это вот "как-то" должен придумать программист. Конечно сильно велосипедить не нужно, но когда человек сам будет искать ответы и решения задачи (не одно конкретное решение, а несколько разных способов/решений), это будет более продуктивно.

Answer 3

[mletov]

Основные структурные единицы Битрикса - информационные блоки и их элементы.
От этого и отталкивайтесь. Много задач тупо сводится к получению списка элементов инфоблока с определенными значениями свойств, т е к написанию аналога sql запроса, только при помощи функций Битрикс.
CIBlockElement::GetIBlockByID и CIBlockElement::GetList на первое время покроют большую часть ваших потребностей.

Что касается массивов $ArResutlt, $ArItem, $ArFiles в шаблонах, то частенько выручает var_dump. По содержимому массива вполне можно понять, за что он отвечает.

Comments

[Arris1]

Спасибо, а разве не получают значения свойств обращением к массивам типа $Arresult? Вроде как при выводе свойств обычно в примерах решение было через них или это неправильно?