[Doc] MAJ manuelle et comprendre les fichiers PATCH

Les tutoriels concernant l'installation,la mise à jour, la conversion ou le déplacement d'un forum phpBB3.

[Doc] MAJ manuelle et comprendre les fichiers PATCH

Messagepar lolovoisin » Ven 28 Nov 2008 13:52

» MAJ manuelle et comprendre les fichiers PATCH
Merci à Morgyanne qui a réalisé toute la base des explications.

Ce tutoriel a pour but de vous guider afin de pouvoir réaliser une mise à jour (MAJ) manuelle en utilisant les fichiers patch (en anglais "Patch File").

1» Que sont les fichiers patch ?
Ces fichiers contiennent toutes les modifications qui ont été réalisées lors d'un passage d'une version à une plus récente.
Ils se trouvent sur la page de téléchargement de phpbb, section [Patch files].


2» Pourquoi utiliser les fichiers patch ?
Il est possible que lors de votre MAJ vous rencontriez des problèmes avec le mode automatique. Dans ce cas, il vous faudra passer par la mise à jour manuelle. C'est là qu'interviennent ces fichiers. Il se nomment généralement phpbb-v1_to_v2.patch, v1 pour la version que vous possédez, v2 pour la version vers laquelle vous allez faire la MAJ.
Ces fichiers peuvent être ouverts avec un éditeur de textes du style notepad++.

3» Comprendre les fichiers patch ?
Afin de bien suivre, vous pouvez télécharger ce fichier zip ( phpBB 3.0.2 - Patch Files (zip) )contenant les fichiers patch.

  • Ex. Ouvrez, dans un éditeur de texte, phpBB-3.0.0_to_3.0.2.patch (avec notepad++, vous obtenez)
    diff -x images -x imageset -crNEB phpbb300/adm/index.php phpbb302/adm/index.php
    *** phpbb300/adm/index.php Sun Jul 6 18:33:26 2008
    --- phpbb302/adm/index.php Sun Jul 6 18:32:56 2008

    ***************
    *** 2,8 ****

    /**
    *
    * @package acp
    ! * @version $Id: index.php 8277 2007-12-12 16:45:58Z acydburn $
    * @copyright (c) 2005 phpBB Group
    * @license http://opensource.org/licenses/gpl-license.php GNU Public License
    *
    --- 2,8 ----
    /**
    *
    * @package acp
    ! * @version $Id: index.php 8591 2008-06-04 11:40:53Z Kellanved $
    * @copyright (c) 2005 phpBB Group
    * @license http://opensource.org/licenses/gpl-license.php GNU Public License
    *
    ***************


    En bleu, c'est le nom du fichier à éditer : adm/index.php
    En orange, ce sont les numérotations de lignes dans le fichier : de la ligne 2 à la ligne 8
      Le premier repère *** 2,8 *** c'est l'ancien fichier
      Le second repère --- 2,8 --- c'est le nouveau fichier
    En vert avec le point d'exclamation en tête de ligne (!), c'est ce qui est modifié.

    En résumé :
    Ouvrez adm/index.php
    Cherchez
    Code: Tout sélectionner
    * @version $Id: index.php 8277 2007-12-12 16:45:58Z acydburn $

    Remplacez par
    Code: Tout sélectionner
    * @version $Id: index.php 8591 2008-06-04 11:40:53Z Kellanved $


  • Autre exemple :
    diff -x images -x imageset -crNEB phpbb300/adm/style/acp_bbcodes.html phpbb302/adm/style/acp_bbcodes.html
    *** phpbb300/adm/style/acp_bbcodes.html Sun Jul 6 18:33:26 2008
    --- phpbb302/adm/style/acp_bbcodes.html Sun Jul 6 18:32:56 2008

    ***************
    *** 103,108 ****
    --- 103,112 ----

    <td style="text-align: center;">{bbcodes.BBCODE_TAG}</td>
    <td style="text-align: right; width: 40px;"><a href="{bbcodes.U_EDIT}">{ICON_EDIT}</a> <a href="{bbcodes.U_DELETE}">{ICON_DELETE}</a></td>
    </tr>
    + <!-- BEGINELSE -->
    + <tr class="row3">
    + <td colspan="2">{L_ACP_NO_ITEMS}</td>
    + </tr>

    <!-- END bbcodes -->
    </tbody>
    </table>


    En bleu, c'est le nom du fichier à éditer : adm/style/acp_bbcodes.html
    En orange, ce sont les numérotations de lignes dans le fichier
      Le premier repère *** 103,108 *** c'est l'ancien fichier
      Le second repère --- 103,112 --- c'est le nouveau fichier
    En bleu clair avec le signe "+" en tête de ligne, c'est ce qui est ajouté.

    En résumé :
    Ouvrez adm/style/acp_bbcodes.html
    Cherchez
    Code: Tout sélectionner
             <td style="text-align: center;">{bbcodes.BBCODE_TAG}</td>
             <td style="text-align: right; width: 40px;"><a href="{bbcodes.U_EDIT}">{ICON_EDIT}</a> <a href="{bbcodes.U_DELETE}">{ICON_DELETE}</a></td>
          </tr>
       <!-- END bbcodes -->
       </tbody>
       </table>

    Dans la ligne, cherchez
    Code: Tout sélectionner
       <!-- END bbcodes -->

    Avant, ajoutez
    Code: Tout sélectionner
       <!-- BEGINELSE -->
          <tr class="row3">
             <td colspan="2">{L_ACP_NO_ITEMS}</td>
          </tr>


  • Dernier exemple :
    diff -x images -x imageset -crNEB phpbb300/adm/style/acp_permission_roles.html phpbb302/adm/style/acp_permission_roles.html
    *** phpbb300/adm/style/acp_permission_roles.html Sun Jul 6 18:33:26 2008
    --- phpbb302/adm/style/acp_permission_roles.html Sun Jul 6 18:32:56 2008

    ***************
    *** 28,38 ****


    <p>{L_EXPLAIN}</p>

    - <form id="acp_roles" method="post" action="{U_ACTION}">
    -

    <br />
    <a href="#acl">&raquo; {L_SET_ROLE_PERMISSIONS}</a>

    <fieldset>
    <legend>{L_ROLE_DETAILS}</legend>
    <dl>
    --- 28,38 ----

    <p>{L_EXPLAIN}</p>

    <br />
    <a href="#acl">&raquo; {L_SET_ROLE_PERMISSIONS}</a>

    + <form id="acp_roles" method="post" action="{U_ACTION}">
    +

    <fieldset>
    <legend>{L_ROLE_DETAILS}</legend>
    <dl>
    ***************


    En bleu, c'est le nom du fichier à éditer : adm/style/acp_permission_roles.html
    En orange, ce sont les numérotations de lignes dans le fichier
      Le premier repère *** 23,38 *** c'est l'ancien fichier
      Le second repère --- 23,38 --- c'est le nouveau fichier
    En vert kaki, avec le signe "-" en tête de ligne, c'est ce qui est supprimé.
    En bleu clair, avec le signe "+" en tête de ligne, c'est ce qui est ajouté.

    En résumé :
    Ouvrez adm/style/acp_permission_roles.html
    Cherchez :
    Code: Tout sélectionner
       <p>{L_EXPLAIN}</p>

       <form id="acp_roles" method="post" action="{U_ACTION}">

       <br />

    Remplacez par
    Code: Tout sélectionner
       <p>{L_EXPLAIN}</p>

       <br />

    Cherchez
    Code: Tout sélectionner
       <a href="#acl">&raquo; {L_SET_ROLE_PERMISSIONS}</a>

       <fieldset>
          <legend>{L_ROLE_DETAILS}</legend>
       <dl>

    Remplacez par
    Code: Tout sélectionner
       <a href="#acl">&raquo; {L_SET_ROLE_PERMISSIONS}</a>

       <form id="acp_roles" method="post" action="{U_ACTION}">

       <fieldset>
          <legend>{L_ROLE_DETAILS}</legend>
       <dl>

Voilà pour l'explication de la légende, ensuite, il suffit d'être attentif et normalement cela va tout seul.
Avatar de l’utilisateur
lolovoisin
Administrateur du site
Administrateur du site
 
Messages: 407
Inscription: Ven 28 Nov 2008 10:18

Retourner vers Tutoriels Installation / Mise à jour /Conversion

Qui est en ligne

Utilisateurs parcourant ce forum: Aucun utilisateur enregistré et 1 invité

cron