Codulle - L'explorateur de code sources

Accueil>> AlBulle >> Albulle0.9.1 >> includes >> js

Informations fichier

Nom du fichier : util.class.php
Taille du fichier : 25 Ko (672 lignes)
Language : PHP

  1. span style="color: #808080; font-style: italic;">////////////////////////////////////////
  2. // Encodage du fichier : UTF-8
  3. // Utilisation des tabulations : Oui
  4. // 1 tabulation = 4 caractères
  5. // Fins de lignes = LF (Unix)
  6. ////////////////////////////////////////
  7.  
  8. ///////////////////////////////
  9. // LICENCE
  10. ///////////////////////////////
  11. //
  12. // © DUCARRE Cédric (SamRay1024), Bubulles Créations, (09/05/2005)
  13. //
  14. // webmaster@jebulle.net
  15. // http://jebulle.net
  16. //
  17. // Ce fichier fait partie d'AlBulle, script de gestion d'albums photos.
  18. //
  19. // Ce logiciel est régi par la licence CeCILL soumise au droit français et
  20. // respectant les principes de diffusion des logiciels libres. Vous pouvez
  21. // utiliser, modifier et/ou redistribuer ce programme sous les conditions
  22. // de la licence CeCILL telle que diffusée par le CEA, le CNRS et l'INRIA
  23. // sur le site "http://www.cecill.info".
  24. //
  25. // En contrepartie de l'accessibilité au code source et des droits de copie,
  26. // de modification et de redistribution accordés par cette licence, il n'est
  27. // offert aux utilisateurs qu'une garantie limitée. Pour les mêmes raisons,
  28. // seule une responsabilité restreinte pèse sur l'auteur du programme, le
  29. // titulaire des droits patrimoniaux et les concédants successifs.
  30. //
  31. // A cet égard l'attention de l'utilisateur est attirée sur les risques
  32. // associés au chargement, à l'utilisation, à la modification et/ou au
  33. // développement et à la reproduction du logiciel par l'utilisateur étant
  34. // donné sa spécificité de logiciel libre, qui peut le rendre complexe à
  35. // manipuler et qui le réserve donc à des développeurs et des professionnels
  36. // avertis possédant des connaissances informatiques approfondies. Les
  37. // utilisateurs sont donc invités à charger et tester l'adéquation du
  38. // logiciel à leurs besoins dans des conditions permettant d'assurer la
  39. // sécurité de leurs systèmes et ou de leurs données et, plus généralement,
  40. // à l'utiliser et l'exploiter dans les mêmes conditions de sécurité.
  41. //
  42. // Le fait que vous puissiez accéder à cet en-tête signifie que vous avez
  43. // pris connaissance de la licence CeCILL, et que vous en avez accepté les
  44. // termes.
  45. //
  46. ///////////////////////////////
  47.  
  48.  
  49. /**
  50. * Librairie de fonctions inclassables.
  51. *
  52. * @author SamRay1024
  53. * @copyright Bubulles Creation - http://jebulle.net
  54. * @since 03/04/2006
  55. * @version 1.4
  56. *
  57. *//**
  58. * Redimensionner une image.
  59. *
  60. * @param [RESOURCE] $img_src Contenu binaire de l'image à redimensionner.
  61. * @param [INTEGER] $larg_mini_max Largeur max de la redimension.
  62. * @param [INTEGER] $haut_mini_max Hauteur max de la redimension.
  63. *
  64. * @return [RESOURCE] Contenu binaire de l'image redimensionnée.
  65. */// On recupere les dimensions de l'image que l'on souhaite redimensionner
  66. // Cree une image vierge de la dimension desiree. Cette fonction permet de ne pas etre limite a 256 couleurs contrairement a "ImageCreate"
  67. 'largeur'], $aNouvellesDimensions['hauteur'] );
  68.  
  69. // On effectue une copie de l'image source vers la miniture
  70. 'largeur'], $aNouvellesDimensions['hauteur'/**
  71. * Calcul les nouvelles dimensions d'une image.
  72. *
  73. * @param [INTEGER] $iLargeurInitiale Largeur initiale de l'image.
  74. * @param [INTEGER] $iHauteurInitiale Hauteur initiale de l'image.
  75. * @param [INTEGER] $iLargeurDemandee Largeur finale souhaitée.
  76. * @param [INTEGER] $iHauteurDemandee Hauteur finale souhaitée.
  77. * @return [ARRAY] Retourne un tableau associatif qui contient les nouvelles dimensions.
  78. * $aResultat['largeur'] & $aResultat['hauteur']
  79. */'largeur' => 0, 'hauteur' => 0 );
  80.  
  81. // si l'image est plus petite que les dimensions demandees, on ne redimensionne pas.
  82. // Pour cela, on force la valeur de la dimension souhaitee a la valeur de la taille de l'image
  83. // de sorte a creer un ratio de 1 pour la dimension
  84. // On calcule le ratio pour la largeur et la hauteur
  85. $fRatioLargeur = $iLargeurDemandee / $iLargeurInitiale;
  86. $fRatioHauteur = $iHauteurDemandee / $iHauteurInitiale;
  87.  
  88. // Et on garde le plus petit afin de ne jamais depasser la taille maximale
  89. $fRatioFinal = ( $fRatioLargeur <= $fRatioHauteur ) ? $fRatioLargeur : $fRatioHauteur;
  90.  
  91. // Connaissant le ratio de la miniature, on peut donc obtenir ses dimensions reelles.
  92. // Ici, on utilise la fonction "round" pour avoir une valeur entiere. Cela nous donne le nombre de pixels que va faire la miniature.
  93. $aResultat['largeur''hauteur'/**
  94. * Traitement d'une image postée par formulaire pour écriture dans un dossier.
  95. *
  96. * Adaptee de http://lecyber.net
  97. *
  98. * Cette méthode permet de traiter une image envoyée par un formulaire. L'image est redimensionnée aux dimensions
  99. * souhaitées (uniquement si elle est plus grande que les dimensions demandées), écrite dans le dossier demandé
  100. * et son nom de fichier peut être préfixé.
  101. *
  102. * @param [STRING] $type Type MIME de l'image envoyée (ie : 'image/gif', 'image.jpg', ...).
  103. * @param [STRING] $srcFile Chemin d'accès complet à l'image que l'on souhaite redimensionner.
  104. * @param [STRING] $destFile Répertoire de destination de stockage de l'image redimensionnée.
  105. * @param [STRING] [$larg_mini_max] Largeur max de la miniature.
  106. * @param [STRING] [$haut_mini_max] Lauteur max de la miniature.
  107. * @param [STRING] [$prefixe] Si ce champ est indiqué, on génère une miniature préfixé de la chaîne que contient cette variable
  108. * sinon, on écrase le fichier d'entrée si le dossier de destination est le même que celui de l'image originale.
  109. *
  110. * @return [STRING] Chemin d'accès à la miniature qui vient d'être générée.
  111. */'' )
  112. {
  113.  
  114. // Recuperation des infos du fichier de destination
  115. // chemin d'acces
  116. // nom du fichier
  117.  
  118. // on reecrit le fichier de destination avec le prefixe et le chemin complet
  119. '/'// creation de l'image en fonction du type MIME
  120. 'image/pjpeg''image/jpeg''image/x-png''image/png''image/gif'// si les deux longeurs max sont nulles, alors on ne redimensionne pas l'image
  121. // Si un second parametre est indique a la fonction ImageJpeg, la miniature est sauvegardee mais elle ne sera pas affichee. Ex : ImageJpeg( $img_src, './miniatures/mini.jpg');
  122. 'image/pjpeg''image/jpeg':
  123. // ecriture de la miniature au format jpeg
  124. 'image/x-png''image/png':
  125. // ecriture de la miniature au format png
  126. 'image/gif':
  127. // ecriture de la miniature au format gif
  128. // destruction du tampon de l'image
  129. /**
  130. * Méthode avancée de lecture de dossiers.
  131. *
  132. * La méthode reçoit un chemin de dossier, ouvre ce dossier et en donne la liste des éléments, qui
  133. * peuvent être ou les dossiers, ou les fichiers, ou les deux.
  134. *
  135. * Les éléments lus du dossiers sont retournés dans un tableau de deux manières différentes. Pour
  136. * les cas où soit les dossiers, soit les fichiers sont demandés, le tableau retourné est un tableau
  137. * indexé classique à une dimension. En revanche pour le cas ou les deux types sont demandés, le tableau
  138. * retourné est un tableau à deux dimensions. La 1ère est associative et contient deux sous-tableaux :
  139. * l'un pour les dossiers, l'autre pour les fichiers.
  140. *
  141. * $aTableauRetour['dir'] contient les dossiers lus.
  142. * $aTableauRetour['file'] contient les fichiers lus.
  143. *
  144. * Les deux sous tableaux sont eux indexés classiquement, tout comme les tableaux de retour sur l'un
  145. * ou l'autre des types demandés (dossiers/fichiers).
  146. *
  147. * @param [STRING] $sDir Chemin du dossier à parcourir.
  148. * @param [STRING] $sMode Modes de parcours du dossier :
  149. * 'DOSSIERS_SEULEMENT' => retourne uniquement les dossiers.
  150. * 'FICHIERS_SEULEMENT' => retourne uniquement les fichiers.
  151. * 'TOUT' => retourne tous les éléments (dossiers ET fichiers).
  152. * @param [ARRAY] $aFiltresDossiers Optionnel. Tableau de dossiers qui ne doivent pas être pris en compte.
  153. * @param [ARRAY] $aFiltresExtensions Optionnel. Tableau à utiliser pour ne garder que les fichiers qui correspondent
  154. * aux extensions données.
  155. * Les extensions doivent être de la forme 'jpg', 'gif', 'exe', ...
  156. * @return [MIXED] FALSE en cas d'erreur, tableau des éléments lus sinon.
  157. */// creation du tableau qui va contenir les elements du dossier
  158. // ajout du slash a la fin du chemin s'il n'y est pas
  159. "/^.*\/$/"'/';
  160.  
  161. // Ouverture du repertoire demande
  162. // si pas d'erreur d'ouverture du dossier on lance le scan
  163. // Parcours du repertoire
  164. '.' && $sItem != '..'// Extraction de l'extension si filtrage sur extensions demandé
  165. '.'// Ajout si autorisé
  166. // Fermeture du repertoire
  167. // Tri des dossiers
  168. // construction tableau retour
  169. 'DOSSIERS_SEULEMENT''FICHIERS_SEULEMENT''TOUT''dir''file'/**
  170. * Génération d'une liste de liens pour faire une pagination.
  171. *
  172. * Cette méthode est une adaptation de celle fourni dans PunBB, le
  173. * script de forums.
  174. *
  175. * ****
  176. * Copyright (C) 2002-2005 Rickard Andersson (rickard@punbb.org)
  177. *
  178. * This function is part of PunBB.
  179. *
  180. * PunBB is free software; you can redistribute it and/or modify it
  181. * under the terms of the GNU General Public License as published
  182. * by the Free Software Foundation; either version 2 of the License,
  183. * or (at your option) any later version.
  184. *
  185. * PunBB is distributed in the hope that it will be useful, but
  186. * WITHOUT ANY WARRANTY; without even the implied warranty of
  187. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  188. * GNU General Public License for more details.
  189. *
  190. * You should have received a copy of the GNU General Public License
  191. * along with this program; if not, write to the Free Software
  192. * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
  193. * MA 02111-1307 USA
  194. * ****
  195. *
  196. * @param [INTEGER] $num_pages Le nombre de pages total.
  197. * @param [INTEGER] $cur_page La page courante.
  198. * @param [STRING] $link_to La destination des url qu'il faut placer dans les liens.
  199. * @return [STRING] Retourne la liste des liens au format HTML.
  200. */// If $cur_page == -1, we link to all pages (used in viewforum.php)
  201. '<span class="pageActive">1</span>''<a href="''&amp;page=1" class="page">1</a>''<span>&hellip;</span>';
  202. }
  203.  
  204. // Don't ask me how the following works. It just does, OK? :-)
  205. '<a href="''&amp;page=''" class="page">''</a>''<span class="pageActive">''</span>''<span>&hellip;</span>';
  206.  
  207. $pages[] = '<a href="''&amp;page=''" class="page">''</a>'/*'&#160;'*/'', $pages);
  208. }
  209.  
  210. /**
  211. * Extraire à gauche de la n-ième sous-chaîne.
  212. *
  213. * Extrait d'une chaine tout ce qui se trouve à gauche de la n-ième sous-chaine
  214. * spécifiée. Par exemple, pour extraire les chemins parents dans une chaine de
  215. * caractères qui contient un chemin :
  216. * echo SousChaineGauche( 'dossier1/dossier2/dossier3/dossier4', '/', 2 );
  217. * => Affiche : dossier1/dossier2
  218. *
  219. * @param [STRING] $sChainePrincipale La chaine dans laquelle on doit faire l'extraction.
  220. * @param [STRING] $sSousChaine La chaine à repérer.
  221. * @param [INTEGER] $iNbOccurences Le nombre d'occurences à partir duquel on garde ce qui se trouve
  222. * à gauche de la sous-chaine.
  223. * @return [STRING] Retourne $sChainePrincipale tronquée.
  224. */''/**
  225. * Extraire à droite de la n-ième sous-chaîne.
  226. *
  227. * Extrait d'une chaine tout ce qui se trouve à droite de la n-ième sous-chaîne
  228. * spécifiée. Par exemple, pour extraire les dossiers enfants dans une chaîne de
  229. * caractères qui contient un chemin :
  230. * echo sousChaineDroite( 'dossier1/dossier2/dossier3/dossier4', '/', 2 );
  231. * => Affiche : dossier3/dossier4
  232. *
  233. * @param [STRING] $sChainePrincipale La chaine dans laquelle on doit faire l'extraction.
  234. * @param [STRING] $sSousChaine La chaine à repérer.
  235. * @param [INTEGER] $iNbOccurences Le nombre d'occurences à partir duquel on garde ce qui se trouve
  236. * à droite de la sous-chaine.
  237. * @return [STRING] Retourne $sChainePrincipale tronquée.
  238. */''/**
  239. * Nettoyer une chaine de chemin d'accès qui provient d'une URL.
  240. *
  241. * Cette méthode permet le nettoyage d'une chaine qui représente un chemin vers un dossier quelconque.
  242. * Elle est destinée à eviter les failles d'accès à des dossiers interdits par une URL. Elle se charge
  243. * donc de repérer les dossiers vides ('//'), les noms tels './' et '../'. En plus, il est possible
  244. * de demander à la méthode d'interdire des dossiers spécifiques dont vous passez le nom par
  245. * l'intermédiaire d'un tableau.
  246. *
  247. * La chaine étant passée par référence, elle n'est pas retournée par la méthode et est directement
  248. * utilisable dans le fichier appelant.
  249. *
  250. * @param [STRING] $sChaine Passée par référence, la chaine est nettoyée des dossiers interdits.
  251. * @param [ARRAY] $aDossiersInterdits Optionnel. Contient une liste de dossiers interdits.
  252. * @return [ARRAY] Retourne la chaine d'accès sous forme de tableau (pour des traitements ultérieurs)
  253. */'';
  254.  
  255. // On eclate le chemin dans un tableau extraire chaque dossier
  256. '/', $sChaine );
  257.  
  258. // on calcul le nombres de dossiers passés dans l'url
  259. // Si des dossiers sont interdits, on construit la fin de l'expression régulière
  260. '|'// nettoyage des dossiers, pour enlever les chaines vides, les accès du type ./ et ../
  261. // et les dossiers interdits
  262. '''/^[.]+$''/'// reconstruction des index du tableau (utilisation d'un tableau vide pour corriger un bogue intervenant occasionnellement)
  263. // Reconstruction de la chaine d'accès nettoyée
  264. '/'/**
  265. * Enlèver le préfixe d'une chaine.
  266. *
  267. * Permet d'effacer tout ce qui se trouve avant un séparateur dans une chaine.
  268. * Le séparateur est lui aussi effacé. Si des espaces se trouvent après le séparateur,
  269. * ils sont de même supprimés.
  270. *
  271. * @param [STRING] $sChaineANettoyer La chaîne dans laquelle enlever un préfixe.
  272. * @param [STRING] $sMarqueur La chaîne qui marque la fin du préfixe.
  273. * @return [STRING] La chaîne nettoyées.
  274. */// Recherche du séparateur
  275. // Extraction de ce qui ce trouve à gauche de la position trouvée
  276. // Si la chaine lue à gauche du séparateur est bien un entier, on peut alors l'enlever
  277. // car on est certain qu'il représente le préfixe.
  278. /**
  279. * Parse un fichier pour remplacer ses pseudos-variables.
  280. *
  281. * Le tableau à passer en paramètres doit être associatif. Les clés de ce tableau doivent
  282. * représenter les éléments à remplacer dans le fichier. Ces clés doivent alors être des
  283. * expression régulières.
  284. *
  285. * De plus, le tableau peut être soit à une dimension soit à deux. Un tableau à une dimension
  286. * signifie que vous parsez un fichier simple. Un tableau à deux dimensions signifie que
  287. * vous devez parser le fichier autant de fois qu'il y a de valeurs dans la première dimension.
  288. *
  289. * En d'autres termes, le remplacement de données dans un fichier simple conduit à présenter un
  290. * tableau de la façon suivante :
  291. * $aElements['/{MON_ELEMENT_1}/'] = 'ce qui va être mis à la place';
  292. * ...
  293. *
  294. * Et pour boucler sur le fichier :
  295. * $aElements[0]['/{MON_ELEMENT_1}/'] = 'ce qui va être mis à la place';
  296. * $aElements[0]['/{MON_ELEMENT_2}/'] = '...';
  297. * ...
  298. * $aElements[1]['/{MON_ELEMENT_1}/'] = '...';
  299. * $aElements[1]['/{MON_ELEMENT_2}/'] = '...';
  300. * ...
  301. *
  302. * /!\ Si le tableau passé en paramètre est à deux dimensions, il faut définir le dernier
  303. * paramètre à True.
  304. *
  305. * @param [String] $sCheminFichier Le chemin d'accès au fichier à parser.
  306. * @param [String] $aElementsARemplacer Le tableau dont les clés sont les expressions régulières d'accès aux pseudo-variables
  307. * et les valeurs le contenu à remplacer.
  308. * @param [Boolean] $bBoucler Optionnel. Si vrai, c'est que le tableau est bi-dimensionnel, donc qu'il s'agit de boucler
  309. * sur plusieurs éléments.
  310. * @return [String] Le contenu du fichier parsé.
  311. */// Lecture fichier et remplacement des pseudos-variables
  312. // Extraction des patterns à remplacer
  313. ''/**
  314. * Créé une liste HTML dont chaque puce représente une information EXIF d'une image au format JPEG.
  315. *
  316. * Les informations retournées par cette méthode sont les suivantes :
  317. * Marque et modèle de l'appareil photo, date et heure de la photo, temps d'exposition,
  318. * sensibilité ISO, ouverture et longueur de la focale.
  319. *
  320. * @param [STRING] $sCheminImage Le chemin d'accès à l'image dont on souhaite obtenir les infos EXIF.
  321. * @return [STRING] Si la photo ne possède pas de données EXIF, une simple phrase est retournée. Sinon
  322. * la méthode retourne une liste <ul>...</ul> avec un élément <li>...</li> par donnée.
  323. * La liste <ul> possède un identifiant, "exif", pour repérer la liste avec une feuille
  324. * de style CSS.
  325. */"<ul id=\"exif\">\n\t""<li>Aucune donnée EXIF pour cette image.</li>\n"'inconnue''ANY_TAG''IFDO'// Marque appareil
  326. '<li><span>Marque de l\'appareil : </span>''Make''IFD0''IFD0']['Make'] !== '''IFD0']['Make''</li>';
  327.  
  328. // Modèle appareil
  329. '<li><span>Modèle de l\'appareil : </span>''Model''IFD0''IFD0']['Model'] !== '''IFD0']['Model''</li>''EXIF'// Date/heure
  330. '<li><span>Date/Heure de la prise de vue : </span>''DateTimeOriginal''EXIF''EXIF']['DateTimeOriginal'] !== '''EXIF']['DateTimeOriginal''</li>';
  331.  
  332. // Temps exposition
  333. '<li><span>Temps d\'exposition : </span>''ExposureTime''EXIF''EXIF']['ExposureTime'] !== '''EXIF']['ExposureTime''</li>';
  334.  
  335. // ISO
  336. '<li><span>Sensibilité ISO : </span>''ISOSpeedRatings''EXIF''EXIF']['ISOSpeedRatings'] !== '''EXIF']['ISOSpeedRatings''</li>';
  337.  
  338. // Longueur focale
  339. '<li><span>Longueur de la focale : </span>''FocalLength''EXIF''EXIF']['FocalLength'] !== '''EXIF']['FocalLength''</li>''COMPUTED'// Ouverture focale
  340. '<li><span>Ouverture de la focale : </span>''ApertureFNumber''COMPUTED''COMPUTED']['ApertureFNumber'] !== '''COMPUTED']['ApertureFNumber''</li>'"</ul>\n"/**
  341. * Tronque la chaîne de catactères passée en paramètre pour la réduire à iNbCaracteres.
  342. * La chaine est complétée avec '...' pour indiquer qu'elle n'est pas complète.
  343. *
  344. * @param [STRING] $sChaineATronquer La chaîne que l'on souhaite tronquer.
  345. * @param [STRING] $iNbCaracteres Le nombres de caractères maximals que doit faire la chaine depuis le début.
  346. * @return [STRING] La chaîne tronquée + '...'.
  347. */'...'''

Liste des projets

Téléchargez Codulle

Publié par Codulle - v0.1.1 - © Bubulles Creations