aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/lukasreschke/id3parser/README.md
diff options
context:
space:
mode:
authorMike Macgirvin <mike@macgirvin.com>2017-11-21 06:40:48 +1100
committerGitHub <noreply@github.com>2017-11-21 06:40:48 +1100
commit250d758d74fa1e117ed11c884a0c26040e696494 (patch)
tree6ec1053cf706b82c44438982ead9ae360939fd83 /vendor/lukasreschke/id3parser/README.md
parent0325efeb350f575f70f18e9f199ad273e5ba1d15 (diff)
parente32f9e0354f159164651d4c7fb697ebe02ad7ea9 (diff)
downloadvolse-hubzilla-250d758d74fa1e117ed11c884a0c26040e696494.tar.gz
volse-hubzilla-250d758d74fa1e117ed11c884a0c26040e696494.tar.bz2
volse-hubzilla-250d758d74fa1e117ed11c884a0c26040e696494.zip
Merge pull request #913 from dawnbreak/dev
Add ID3Parser library.
Diffstat (limited to 'vendor/lukasreschke/id3parser/README.md')
-rw-r--r--vendor/lukasreschke/id3parser/README.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/vendor/lukasreschke/id3parser/README.md b/vendor/lukasreschke/id3parser/README.md
new file mode 100644
index 000000000..62af96e7b
--- /dev/null
+++ b/vendor/lukasreschke/id3parser/README.md
@@ -0,0 +1,29 @@
+# ID3 Parser
+
+This is a pure ID3 parser based upon [getID3](https://github.com/JamesHeinrich/getID3). It supports the following ID3
+versions inside MP3 files:
+
+- ID3v1 (v1.0 & v1.1)
+- ID3v2 (v2.2, v2.3 & v2.4)
+
+## Usage
+
+```php
+<?php
+require_once __DIR__ . '/vendor/autoload.php';
+
+$analyzer = new \ID3Parser\ID3Parser();
+$tags = $analyzer->analyze('/tmp/myfile.mp3'));
+```
+
+## Why should I use this package over getID3 directly?
+
+getID3 has evolved to a state where it is having a lot of other features such as parsing a ton of other file formats and
+for some of it, it is even invoking external programs on the server. For example it is nowadays even supporting SVG files.
+
+Such a big parsing library can easily be haunted by security related bugs as for example [CVE-2014-2053](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2014-2053)
+and some other vulnerabilities have proven. This library takes the ID3 parsing code from getID3 and strips all other
+functions.
+
+In cases where reading the ID3v2 tags is sufficient this library is likely to be a more secure approach, if you need any
+of the advanced features of getID3 however you're likely to be unhappy with this library.