Создание каталога

Каталоги - это основа Ampache. В них хранится информация обо всех ваших музыкальных файлах, видеозаписях и других данных. Существует 2 основных типа каталогов в Ampache: Удаленный и Локальный. Удаленные каталоги предназначены только для использования с XML-RPC, а также для того, чтобы можно было создать ссылку на другие сервера Ampache. Локальные же ссылаются на различные директории в файловой системе сервера, на котором Ampache установлен. Для того чтобы создать ваш первый каталог, зайдите в Ampache как администратор, после чего откройте вкладку меню 'Администратор' и нажмите на 'Добавить' в разделе 'Каталоги'.

• Имя каталога – Это то имя, которое будет отображаться в списке каталогов Ampache.
• Путь – Это директория в файловой системе сервера, на котором установлен Ampache. Это может быть как точка монтирования NFS, так и сетевой диск Windows, а также многое другое. Учтите, что требуется полный путь, а не относительный.
• XML-RPC ключ – Рассматривать этот параметр не будем, так как он не имеет отношения к локальным каталогам. Оставьте его пустым.
• Шаблон имени файла – Данный параметр определяет шаблон, по которому Ampache попытается получить информацию об исполнителе и т.д. из имени файлов. Также он определяет, как Ampache будет сортировать/переименовывать файлы в этом каталоге.
• Шаблон папки – Аналогично шаблону имени файла, за исключением того, что этот шаблон определяет поведение Ampache с папками, а не файлами.
• Собрать обложки альбомов – Данный параметр определяет будет ли Ampache после создания каталога искать и добавлять обложки альбомов.
• Создавать списки воспроизведения из m3u файлов – Данный параметр определяет будет ли Ampache искать .m3u файлы в вашем каталоге, пробовать распознавать их и создавать списки проигрывания на их основе.

Каждый администратор может управлять каталогами либо через веб-интерфейс, либо используя скрипт '/bin/catalog_update.inc' в командной строке. Этот скрипт в качестве аргумента принимает имя каталога, который надо обновить. Если каталог не указан, то скрипт проводит процедуру обновления над каждым каталогом. Далее следует список возможных операций, которые можно выполнять над каталогами, а также их поведение.

• Добавить – Ищет новые файлы в главной директории каталога (которая указывалась при его создании) и добавляет найденные.
• Проверить – Проверяет существующие файлы чтобы убедиться, что в тегах содержится правильная информация.
• Очистить – Удаляет всех артистов, альбомы, и так далее, на которые нет ссылок. Также удаляет из каталога те треки, которые Ampache не смог прочитать.
• Обновить – Выполняет очистку, проверку, а затем добавление. Это удобно, если требуется сделать всё вместе.
• Собрать обложки – Ищет обложки для альбомов и добавляет их в каталог.
• Удалить – Удаляет данный каталог.

Каталоги в Ampache сделаны таким образом, что даже если процесс обновления оборвется во время выполнения любой из операций, ваш каталог останется целым и неповрежденным. Так что если вы столкнулись с ошибкой, не волнуйтесь! Если ваша проблема заключается в том, что Ampache неправильно считывает теги из треков, или как-то иначе связана с ними, посетите страницу Чтение тегов / мета информации.

Всегда включайте журналирование когда решаете проблемы со своими каталогами.

Ampache необходимо иметь права на чтение всех файлов из каталога и права на чтение+исполнение для всех директорий. Если вы столкнетесь с тем, что Ampache не сможет прочитать какой-либо файл или директорию, дважды проверьте права файлов. Далее приведены команды, которые установят необходимые для работы Ampache права. Но прежде, перейдите в корневую директорию вашего каталога с музыкой или видео, так как эти команды будут рекурсивно изменять права, начиная с текущей директории.

cd /путь/к/вашему/каталогу
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

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

При использовании сетевых дисков windows, убедитесь, что пользователь, запустивший　apache, также является владельцем этого сетевого диска и имеет достаточные права для чтения его содержимого.

Также, стоит отметить, что selinux при настройках по умолчанию может не позволять apache читать CIFS или NFS разделы. Прочтите man по booleans(8), getsebool(8), и setseool(8). Selinux также должен записывать нарушения прав доступа в системный журнал (обычно - /var/log/messages).

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

• Убедитесь, что служба Apache запущена с правами пользователя, а не системными (не из-под пользователя SYSTEM). Пользователь, под именем которого будет запущен сервис, должен иметь необходимые права для чтения файлов и директорий, которые нужно добавить в каталог Ampache.
  • В Windows откройте панель служб, нажмите 'Пуск > Настройки > Панель управления > Администрирование > Службы'.
  • В этой панели, выберите службу Apache, нажмите правой кнопкой мыши по ней и выберите Свойства.
  • Выберите вкладку Вход в Систему и введите имя вашего пользователя. Если вы используете систему доменов Windows или Active Directory, измените поле учетной записи на <домен>\<имя_пользователя>. Например, mydomain\myaccount. Введите пароль, если он присутствует, после чего нажмите кнопку Разрешить, а затем, OK.
• Когда будете добавлять каталог, не забудьте указать сетевой путь с двойными наклонными чертами, как в примере: \\192.168.0.1\folder\Музыка

Несмотря на то, что Ampache использует set_time_limit(0) для того, чтобы переопределить любые лимиты времени выполнения PHP скрипта, иногда использование этой функции запрещено в файле настройки PHP. Если вы сталкиваетесь с проблемой нехватки памяти (По умолчанию 32Мб) или же превышается лимит времени исполнения скрипта, измените вручную файл php.ini и увеличьте соответствующие параметры. Если PHP запущен в качестве модуля веб-сервера, потребуется перезапустить его. Не волнуйтесь, если память кончится во время создания каталога. Вам не нужно будет удалять его и начинать все заново, просто запустите процесс заново, и Ampache начнет с того места, на котором остановился. Для получения большей информации соответствующих проблемах и их возможных причинах прочтите следующие статьи:

• Лимит времени исполнения в PHP
• Безопасный режим в PHP
• Директива Timeout в Apache2
• Настройка предельного времени в IIS 6.0
• Включение журналирования в Ampache

Функция Getid3() не должна занимать более 32Мб программной памяти, если она работает корректно, однако если в процессе обработки встретится файл, который не будет распознан корректно и затребуется слишком много памяти, то в таком случае процесс создания каталога может зависнуть. Единственный способ решить эту проблему - либо вручную перекодировать и перепрописать теги в этот файл, либо просто-напросто убрать его из вашей коллекции. Чтобы выяснить, с каким файлом проблема включите журналирование и посмотрите на имя последнего обработанного файла.

Начиная с 3.4-Beta2, Ampache позволяет добавлять только файлы, имена которых содержат символы из кодировки, указанной в /config/ampache.cfg.php в параметре site_charset. Если какие-либо из ваших файлов корректно в каталог не добавляются или Ampache сообщает об ошибке кодировки, либо переименуйте этот файл вручную, либо воспользуйтесь скриптом, находящимся в /bin - fix_filenames.inc.