MAJ manuelle et comprendre les fichiers PATCH Intermédiaire

MAJ manuelle et comprendre les fichiers PATCH


- 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.

04/03/2014 - modifié par Geo pour convertir le sujet en article.
Avatar de l’utilisateur
lolovoisin
Rugbix ³
Rugbix ³
 
Rédigé le: 01 Sep 2008 à 12:30
Articles: 33
Contributeurs:
Noter cet article: 123456 Votants: 1
Mots-clés: MAJ, manuelle, et, comprendre, les, fichiers, PATCH

Retourner vers Mise à jour