====== Если вы новичок в Limb3... ======

===== Основные идеи =====

Limb3 - это не монолитный фреймворк, как например, Symfony. Limb3 состоит из набора осносительно независимых [[limb3_2007_4:ru:packages_architecture|пакетов]], каждый из которых должен решать свою задачу.

Limb3 должен быть установлен в папку, которая доступна через get_include_path(). Вы можете или поправить свой php.ini файл или же изменять include_path прямо в базовом файле проекта:

<code php>
set_include_path('path/to/limb/installation' . PATH_SEPARATOR . get_include_path());
</code>

'path/to/limb/installation' должен указывать на папку, где лежит limb, а не на саму папку с limb, то есть /var/dev/lib/ вместо /var/dev/lib/limb/.


===== Скачивание Limb3 =====

Если вы не собираетесь участвовать в разработке Limb3, то самым простым способом можно получить Limb3 через PEAR канал. На PEAR канале выкладываются самые стабильные релизы и они появляются там наиболее рано. Однако Limb3 также можно получить с sourceforge.net и с build-сервера. см. раздел [[limb3_2007_4:ru:how_to_download|Где и как скачать Limb3]].



===== Примеры для начинающих =====

Для освоения Limb3 есть 2 пошаговых примера:
  * [[limb3_2007_4:ru:tutorials:basic|базовый пример]], где показаны только самые основы использования пакетов WEB_APP, ACTIVE_RECORD и WACT.
  * [[limb3_2007_4:ru:tutorials:shop|пример создания простого электронного магазина]], в котором объяснены почти все часто используемые компоненты Limb3.

Рабочий код примеров можно найти в SVN репозитории по адресу:
<code>
  svn co https://svn.limb-project.com/limb/3.x/examples
</code>

или же в разделе [[http://projects.limb-project.com/|Проекты]], где представлены рабочие копии этих примеров, а также ссылки для скачивания исходных кодов.

Вы сможете найти в настоящее время следующие примеры и приложения:
  * реализацию основного сайта http://limb-project.com на базе Limb3
  * пример создание простейшего CRUD-приложения
  * пример создания простого электронного магазина
  * пример реализации корпоративной визитки с каталогом
  * примеры использования шаблонизатора WACT
  * готовые приложения на базе Limb3: [[http://syncman.limb-project.com|Syncman]] и [[http://buildman.limb-project.com|Buildman]]






===== Документация =====

Документация на Limb3 достаточно актуальна. Наиболее точными являются разделы [[limb3_2007_4:ru:packages:wact|про WACT]] и [[limb3_2007_4:ru:packages:active_record|про использование ACTIVE_RECORD]]. Эти разделы мы рекомендуем прочитать после прохождения [[limb3_2007_4:ru:tutorials:basic|базового примера]].

Также есть [[limb3_2007_4:ru:packages|описания на большинство пакетов Limb3]]. В этих разделах информация частично, а кое-где и сильно, устарела. Хотя мы постепенно исправляем ситуацию, но это требует очень много времени, и поэтому прогресс идет достаточно медленно. Так что, если что-то из этих разделов будет вам неясным, то можете спрашивать на [[http://forum.limb-project.com/|форуме]] - мы стараемся отвечать на большинство вопросов оперативно и развернуто.

===== Модульные тесты =====

Для большинства классов и подсистем Limb3 существуют модульные тесты. Те разработчики, которые умеют читать тесты, смогут найти множество примеров использования тех или иных классов в тестах. Подробнее о тестах и способах из запуска можно прочитать в [[limb3_2007_4:ru:how_to_run_tests|соответствующем разделе]].




===== Варианты использования Limb3 =====

Вы можете использовать Limb3 как полностью законченный фреймворк, создавая на его базе приложения или же использовать из него только отдельные пакеты, например:  
  * TESTS_RUNNER - пакет для запуска тестов
  * ACTIVE_RECORD - имплементация паттерна ActiveRecord, позволяющая прозрачно отражать объекты в реляционную БД
  * WACT - шаблонизатор
  * TOOLKIT - инструмент для управления зависимостями
  * и т.д.

===== Если вам нужна помощь =====

Не стесняйтесь, спрашивайте на [[http://forum.limb-project.com|форуме]]. Мы всегда постараемся ответить на ваши вопросы.