Ajoute une règle de réécriture d'URL

# output_add_rewrite_var

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

output_add_rewrite_var — Ajoute une règle de réécriture d'URL

### Description

output_add_rewrite_var ( string `$name` , string `$value` ) : bool

Cette fonction ajoute une nouvelle paire nom/valeur au mécanisme de réécriture d'URL. Le nom et la valeur sera ajouté aux URL (en tant que paramètre GET) et aux formulaires (en tant que champs cachés) de la même façon que pour les identifiants de session lorsque la réécriture d'URL est activée avec session.use_trans_sid.

Ce comportement est contrôlé par les options url_rewriter.tags et url_rewriter.hosts du php.ini.

> Note: L'appel à cette fonction démarre implicitement la temporisation de sortie si elle n'est pas déjà activée.

### Liste de paramètres

`name`

  Le nom de la variable.

`value`

  La valeur de la variable.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Historique

Version | Description
--- | ---
7.1.0 | Avant php 7.1.0, la réécriture des variables définis par output_add_rewrite_var() utilisez la même mémoire tampon de sortie du module de session trans sid. Depuis PHP 7.1.0, le tampon de sortie dédié est utilisé, url_rewriter.tags est utilisé uniquement pour les fonctions de sortie, ajout de url_rewriter.hosts.

### Exemples

Exemple #1 Exemple avec output_add_rewrite_var()

`<?php
output_add_rewrite_var('var', 'value');
// Quelques liens
echo '<a href="file.php">link</a>
<a href="http://example.com">link2</a>';
// un formulaire
echo '<form action="script.php" method="post">
<input type="text" name="var2" />
</form>';
print_r(ob_list_handlers());
?>`

L'exemple ci-dessus va afficher :

    <a href="file.php?var=value">link</a>
    <a href="http://example.com">link2</a>

    <form action="script.php" method="post">
    <input type="hidden" name="var" value="value" />
    <input type="text" name="var2" />
    </form>

    Array
    (
        [0] => URL-Rewriter
    )

### Voir aussi

- output_reset_rewrite_vars() - Annule la réécriture d'URL
- ob_flush() - Envoie le tampon de sortie
- ob_list_handlers() - Liste les gestionnaires d'affichage utilisés
- url_rewriter.tags
- url_rewriter.hosts
- session.trans_sid_tags
- session.trans_sid_hosts