php id3 get tag
Php id3 get tag
getID3() is released under multiple licenses. You may choose from the following licenses, and use getID3 according to the terms of the license most suitable to your project.
GNU GPL:
GNU LGPL:
Mozilla MPL:
getID3 Commercial License:
Copies of each of the above licenses are included in the licenses/ directory of the getID3 distribution.
If you want to donate, there is a link on https://www.getid3.org for PayPal donations.
Q: How can I check that getID3() works on my server/files?
A: Unzip getID3() to a directory, then access /demos/demo.browse.php
Q: I have a question, or I found a bug. What do I do?
A: The preferred method of support requests and/or bug reports is the forum at http://support.getid3.org/
It’s highly recommended that you sign up for notification from Sourceforge for when new versions are released. Please visit: http://sourceforge.net/project/showfiles.php?group_id=55859 and click the little «monitor package» icon/link. If you’re previously signed up for the mailing list, be aware that it has been discontinued, only the automated Sourceforge notification will be used from now on.
What does getID3() do?
Reads & parses (to varying degrees):
See /demos/demo.basic.php for a very basic use of getID3() with no fancy output, just scanning one file.
See structure.txt for the returned data structure.
For an example of a complete directory-browsing, file-scanning implementation of getID3(), please run /demos/demo.browse.php
See /demos/demo.mysql.php for a sample recursive scanning code that scans every file in a given directory, and all sub-directories, stores the results in a database and allows various analysis / maintenance operations
To analyze remote files over HTTP or FTP you need to copy the file locally first before running getID3(). Your code would look something like this:
See /demos/demo.write.php for how to write tags.
What does the returned data structure look like?
It is recommended that you look at the output of /demos/demo.browse.php scanning the file(s) you’re interested in to confirm what data is actually returned for any particular filetype in general, and your files in particular, as the actual data returned may vary considerably depending on what information is available in the file itself.
See above except errors are thrown (so you will only get one error).
getID3() has been tested on many systems, on many types of files, under many operating systems, and is generally believe to be stable and safe. That being said, there is still the chance there is an undiscovered and/or unfixed bug that may potentially corrupt your file, especially within the writing functions. By using getID3() you agree that it’s not my fault if any of your files are corrupted. In fact, I’m not liable for anything 🙂
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
Q: Can I use getID3() in my program? Do I need a commercial license?
A: You’re generally free to use getID3 however you see fit. The only case in which you would require a commercial license is if you’re selling your closed-source program that integrates getID3. If you sell your program including a copy of getID3, that’s fine as long as you include a copy of the sourcecode when you sell it. Or you can distribute your code without getID3 and say «download it from getid3.sourceforge.net»
Why is it called «getID3()» if it does so much more than just that?
v0.1 did in fact just do that. I don’t have a copy of code that old, but I could essentially write it today with a one-line function:
Known Bugs/Issues in getID3() that may be fixed eventually
Known Bugs/Issues in getID3() that cannot be fixed
How to install php_id3 on wamp?
I have tried to find the file people are talking about namely php_id3.dll. I have read that you can install it with the id 3 on wamp but when i google it i get all sorts of scamsites.
Does anyone know where i can find it?
4 Answers 4
All the information you need is in the official PHP documentation:
The error you get (undefined function) means the ID3 extension is not enabled in your PHP configuration:
If you don’t have the ID3 extension file (it is probably named php_id3.dll or something similar), you must either find a place to download it, or build it yourself from source.
Move it your project location, you require to include the file. Ex: require(«getid3/getid3.php»);
A DLL for this PECL extension is currently unavailable. See also the building on Windows section.
I was expecting something like apt-get install php5-id3v2, but this lib seems way to old and abandonned for that. It may still work, but is not very intuitive to install, for sure.
I installed the command line tool id3v2, which does exactly what I need : read and modify basic tags (album, artist, title, comment. )
It installs with a simple
and is very easy to use. here is an extract from the man page :
note :There was also another tool I didn’t bother to try, in the same post : «eyeD3»
Расширения PHP для работы с mp3
На сегодняшний день музыкальные магазины online, наподобие Musikload[1], становятся все более распространенными и пользуются бешенной популярностью. В этой статье мы расскажем как можно читать мета-информацию mp3-файла средствами PHP, что поможет вам в создании каталога музыки. Это очень просто, поддержка базы данных не нужна.
Откуда знает MP3-Player, например Winamp информацию об исполнителе или названии композиции, которую он проигрывает? Может быть, он сам каким-то чудным образом узнает название песни и альбома? Нет, здесь нет никакого волшебства! Подобная информация содержится в самих файлах. Музыкальные файлы других форматов таких как WMA или Ogg Vorbis также содержат подобную информацию, но здесь речь пойдет о файлах в формате mp3.
Спецификация mp3 определяет способ хранения музыкальных данных, однако не предусматривает никакой возможности для сохранения метаданных композиции, таких как название и исполнитель. Чтобы обойти это ограничение был разработан стандарт ID3. Согласно этой спецификации, метаданные должны быть помещены в так называемые ID3-теги, которые независимо от используемого стандарта ID3, помещаются в конец или начало файла. ID3-теги версии 1 (ID3v1-Tags) представляют собой простейшую конструкцию, которая дописывается в конец файла. Ее объем не должен превышать 128 байт. Структура тега такова: после строкового значения “TAG» следует информация о названии (30 символов), исполнителе (30 символов), альбоме (30 символов), годе записи (четырехзначное число), комментарий (30 символов), жанр (1 байт). Тег с подобной структурой обозначается как ID3v1.0-Tag. В дополнение к этому существует еще стандарт ID3v1.1-Tag, который встречается значительно чаще, поскольку позволяет сохранять информацию о порядковом номере композиции в альбоме. Вследствие этого был урезан до 28 символов размер комментария. Сразу после комментария следует нуль-байт, а последующий байт содержит информации о номере трэка. На иллюстрации один и два видна структура обоих стандартов.
PEAR придет на помощь!
Для считывания информации из ID3v1 тегов, в библиотеку PEAR уже был включен пакет MP3_Id[3], который поможет Вам без проблем извлекать информацию из тега, или наоборот записывать. Если в файл отсутствует ID3-тег, вы можете его создать. Листинг 1 показывает как можно считывать информацию из тегов. Создается объект класса MP3_ID, считывается файл, а затем метод getTag() извлекает данные, которые помещаются для дальнейшей обработки в отдельные поля объект. Листинг 2 показывает результат действия программы листинга 1. Общий обзор доступных полей вы найдете в документации по пакету на домашней странице PEAR.
Используем PECL
В конце лета 2004 года появилось расширение PHP ext/id3[7]. Разрабатывается в рамках PECL[6]. В отличие от MP3_ID эта библиотека написана не на PHP, а на C, поэтому она должно работать несколько быстрее. Однако библиотека не входит в стандартный комплект PHP-исходников, к тому же на сегодняшний день отсутствует стабильная версия, хотя функции отвечающие за чтение и запись ID3-тегов считаются стабильными.
Если вы хотите использовать именно это расширение, для установки необходимо воспользоваться либо PEAR-installer, либо откомпилировать php, включив поддержку данного расширения. Если вы используете WINDOWS, существует возможность скачать уже откомпилированную DLL для версии php 5.0 или 5.01 с сайта PHP-Snapshot[9], поместить ее в каталог с расширениями php (например c:phpext), подключить через php.ini. Чтобы воспользоваться расширением, вы должны иметь PHP 4.3 или более позднюю версию, поскольку библиотека использует Streams-API.
Само собой разумеется, библиотека позволяет изменять содержимое ID3-тегов. Для этого вам не нужно ничего, кроме массива, представленного в листинге 6, и функции id3_set_tag(). В качестве первого параметра функция принимает имя изменяемого mp-3 файла, а в качестве второго — массив с необходимыми данными. Третий параметр необязателен и представляет собой константу, указывающую версию ID3-тега. В существующей версии библиотеки функция id3_set_tag() может работать только с тегами версии 1.0 или 1.1. Листинг 7 содержит необходимый php-код. В дополнение к этому, листинг 8 показывает как с помощью функции id3_remove_tag можно удалить существующий ID3-тег.
Ext/id3 содержит еще несколько полезных функций, которые позволяют определить версию ID3-тега (id3_get_version) или манипулируют со списком музыкальных направлений и их id, представленных в виде целого числа типа integer. Надо сказать, что данное число мало подходит для указания музыкального направления.
Listing 5:
Следующее поколение
Несмотря на то, что с помощь ID3v1-тегов уже можно сохранять важнейшую информацию о содержимом mp3-файла, уже проявляются ограничения версий 1.0 и 1.1:
из-за фиксированного размера тега ограничен объем сохраняемой информации
ограничено количество сохраняемых атрибутов
Как мы видим, расширить объем пространства, отведенный под ID3v1 теги нельзя, Существую трудности с сохранением информации о названии композиции, исполнителе, альбоме, комментарии, если размер данных превышает 30 символов. Допустим, вам нужно указать название The Hitchhiker’s Guide to the Galaxy, используя стандарт ID3v1, вы можете сохранить лишь The Hitchhiker’s Guide to. Та же ситуации наблюдается с указанием музыкального направления. Для этого выделяется только один байт, вследствие этого количество музыкальных направлений не может превышать 256. Наверное, сегодня этого достаточно, но кто знает, сколько в будущем появится еще музыкальных направлений.
Чтобы преодолеть указанные ограничения был введены ID3-теги версии 2[2], или короче ID3v2. ID3v2-теги записываются в начало файла, собственно перед самими аудио данными. Информация организована в отдельные единицы, которые обозначаются как фреймы. ID3v2 — это формат-контейнер, то есть, существует возможность при изменении тега вводить новые фреймы. Из этого следует, что ID3v2 может содержать значительно больше информации, чем ID3v1. Это может быть информация об авторских правах, битрейте, (BMP) или, наконец, полный текст песни или изображения. В дополнение к этому можно по желанию добавлять новые фреймы. Вот важнейшие достоинства данного формата:
Никаких ограничений на объем сохраняемой информации
Гибкость и расширяемость
Возможность сжатия содержимого тегов
Поддержка Unicode
Возможность хранить бинарные данные, например изображения и файлы.
Из-за расширенных возможностей ID3v2-теги, несколько труднее поддаются считыванию, чем ID3v1-теги. Хорошая новость состоит в том, что ext/id3 уже позволяет извлекать важнейшую информацию. Если вы исполните код, помещенный в листинг 9, вы получите тот же результат, что и в листинге 10. Проделав это, вы сможете убедиться, что объем выводимых данных значительно шире, чем тот, что показан в листингах 5 и 6.
Каждый фрейм ID3v2-тега обладает уникальным ID. Ext/id3 содержит две функции, которые позволяют узнать содержимое фрейма. Это id3_get_frame_short() и id3_get_frame_long_name(). В качестве параметра они принимают id фрейма и возвращают его описание.
В будущих версиях ext/id3 будет содержать другие полезные функции, которые позволят считывать или записывать фреймы, соответствующие спецификации ID3.
Дополнительная информация
Прежде чем вы организуете бизнес, связанный с продажей музыкальных композиций online, мы вам расскажем еще о нескольких полезных возможностях библиотеки MP3_Id. С помощью нее можно не только считывать информацию ID3- тегов, она позволяет получить некоторую интересную информацию о самом mp3-файле. Речь идет о битрейте, длительности звучания и других полезных свойствах. Подобные сведения можно получить при помощи метода study(), а дальше посредством метода getTag(), можно выбирать необходимые данные. Листинг 12 показывает как это работает. Результат работы программы показан в листинге 13. К сожалению, эти возможности недостаточно документированы, т.е. трудно разобраться какой атрибут можно считать при помощи getTag() или изменить посредство setTag(). В этом случае необходимо изучить код модуля MP3/Id.php.
Выводы
В этой статье мы рассмотрели существующие возможности извлечения информации из mp-3 файлов средствами PHP. Обе библиотеки (MP3_Id и id3) легки в использовании и содержать необходимые функции. Одна библиотека написана на PHP, другая на C. Выбор того или иного варианта определяется вашими предпочтениями и возможностями хостинга.
id3_set_tag — Обновляет информацию в ID3 теге
Описание
id3_set_tag() используется для изменения информации, сохранённой в ID3 теге. Если тег отсутствует, он будет добавлен в файл.
Список параметров
Вместо имени файла можно передать потоковый ресурс
Ассоциативный массив ключей и значений тега.
Следующие ключи могут быть использованы в ассоциативном массиве:
| ключ | возможные значения | доступен с версии |
|---|---|---|
| title | строка длиной максимум 30 символов | v1.0, v1.1 |
| artist | строка длиной максимум 30 символов | v1.0, v1.1 |
| album | строка длиной максимум 30 символов | v1.0, v1.1 |
| year | 4 цифры | v1.0, v1.1 |
| genre | число в интервале от 0 до 147 | v1.0, v1.1 |
| comment | строка длиной максимум 30 символов (30 в v1.1) | v1.0, v1.1 |
| track | целое число в интервале от 0 до 255 | v1.1 |
Позволяет определять версию ID3 тега, так как MP3 файл может содержать теги версии 1.х и 1.2.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Примеры
Пример #1 Пример использования id3_set_tag()
Если файл доступен для записи и содержит тег версии 1.0, то вывод будет следующим:
Примечания
Замечание: В настоящее время функция id3_set_tag() поддерживает только версию 1.0 и 1.1.
Смотрите также
Php id3 get tag
Если кто-то сможет сделать работающий пример, соответствующий моим условиям (нужно изменить комментарии, название, и добавить в mp3 картинку) достойную оплату гарантирую.
|
