Introduction

Le format de fichier OGG/Vorbis, comme définit par http://www.vorbis.com/, est un schéma pour la compression de flux audio par de multiples facteurs avec un minimum de perte de qualité. Cette extension ajoute le support Ogg Vorbis aux gestionnaires d'URL de PHP. Lorsqu'utilisé en mode lecture, les données compressées OGG/Vorbis sont déployées en audio PCM brute en un des six formats d'encodage PCM listés ci-dessous.

Pré-requis

Cette extension nécessite PHP >= 4.3.0, libogg >= 1.0, et libvorbis >= 1.0.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Installation

oggvorbis est installé en utilisant le processus d'installation des paquets PECL.

$ pear install oggvorbis
Copiez le fichier résultant oggvorbis.so dans un dossier approprié et ajoutez extension=oggvorbis.so à votre php.ini ou chargez-le dynamiquement dans votre script PHP en utilisant dl('oggvorbis.so');

Options de contexte

Tableau 1. Options personnalisées OGG/Vorbis

Option	Définition	Pertinence	Défaut
pcm_mode	Encodage PCM utilisé. Voir les constantes ci-dessous.	Lecture / Écriture	`OGGVORBIS_PCM_S16_LE`
rate	Taux d'échantillonage PCM. Mesuré en Hz.	Écriture uniquement	`44100`
bitrate	Débit d'encodage moyen Vorbis / Débit d'encodage variable. Mesuré en bps (ABR) ou en niveau de qualité (VBR : 0.0 à 1.0). 128000 ABR équivaut à 0.4 VBR.	Écriture uniquement	`128000`
channels	Nombre de canaux PCM. 1 == Mono, 2 == Stéréo.	Écriture uniquement	`2`
serialno	Nombre de séries de flux dans un fichier. Doit être unique dans un fichier. Parcequ'il est potentiellement possible de sélectionner plusieurs nombres de séries dans un fichier chaîné, faites l'effort d'assigner manuellement des nombres uniques lors de l'encodage.	Écriture uniquement	Random
comments	Tableau associatif de commentaires de fichier. Peut être traduit par `strtoupper($name) . "=$value"`. Note : Cette option de contexte n'est pas disponible en oggvorbis-0.1	Écriture uniquement	`array('ENCODER' => 'PHP/OggVorbis, http://pear.php.net/oggvorbis')`

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Tableau 2. OGG/Vorbis supporte l'encodage PCM dans les formats suivants :

Constante	Définition
`OGGVORBIS_PCM_U8`	PCM 8-bit non-signé.
`OGGVORBIS_PCM_S8`	PCM 8-bit signé.
`OGGVORBIS_PCM_U16_LE`	PCM 16-bit non-signé. Arrangements normaux `Little Endian`.
`OGGVORBIS_PCM_U16_BE`	PCM 16-bit non-signé. Arrangements normaux `Big Endian`.
`OGGVORBIS_PCM_S16_LE`	PCM 16-bit signé. Arrangements normaux `Little Endian`.
`OGGVORBIS_PCM_S16_BE`	PCM 16-bit signé. Arrangements normaux `Big Endian`.

Table des matières
Utilisation -- Exemples d'utilisation du gestionnaire ogg://.