Subversion Repositories eFlore/Applications.cel

Rev

Rev 2045 | Rev 2056 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2025 aurelien 1
<?php
2
/**
3
* @package   jrest
4
* @author    Aurélien Peronnet <aurelien@tela-botania.org>
5
* @copyright 2010, 2013 Tela-Botanica
6
* @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
7
*
8
* Librairie de liaison d'images et d'observation à des mots clés en utilisant la méthode
9
* path enumeration
10
*/
11
 
12
class GestionMotsClesChemin {
13
 
14
	private $config;
15
	private $mode;
16
 
17
	private $table_liaison;
18
	private $table_mots_cles;
19
 
2032 aurelien 20
	//TODO: trigger pour les tables liaisons
21
 
2026 aurelien 22
	public function GestionMotsClesChemin($config, $mode = 'obs') {
2025 aurelien 23
		$this->config = $config;
24
		//TODO: switch suivant mode
2027 aurelien 25
		$this->mode = $mode;
26
 
27
		if($mode == 'obs') {
2042 aurelien 28
			$this->table_liaison = 'cel_mots_cles_obs_liaison';
29
			$this->table_mots_cles = 'cel_arbre_mots_cles_obs';
2027 aurelien 30
		} else {
2042 aurelien 31
			$this->table_liaison = 'cel_mots_cles_images_liaison';
32
			$this->table_mots_cles = 'cel_arbre_mots_cles_images';
2027 aurelien 33
		}
2025 aurelien 34
	}
2027 aurelien 35
 
2025 aurelien 36
	public function obtenirArbre($id_utilisateur, $chemin = "/") {
37
		$requete = "SELECT * FROM ".$this->table_mots_cles." ".
38
		"WHERE id_utilisateur = ".Cel::db()->proteger($id_utilisateur)." AND ".
2026 aurelien 39
		"chemin LIKE ".Cel::db()->proteger($chemin."%")." ".
40
		"ORDER BY chemin";
2025 aurelien 41
 
2026 aurelien 42
		$arbre = Cel::db()->requeter($requete.' -- '.__FILE__.':'.__LINE__);
43
		usort($arbre, array('GestionMotsClesChemin', 'comparerProfNoeuds'));
2025 aurelien 44
 
45
		return $arbre;
46
	}
47
 
2042 aurelien 48
	public function obtenirIdsMotsClesParIdParent($id_utilisateur, $id_mot_cle) {
49
		$requete = "SELECT id_mot_cle FROM ".$this->table_mots_cles." ".
50
		            "WHERE chemin LIKE CONCAT(".
51
		            	"(SELECT chemin FROM ".$this->table_mots_cles." ".
52
		            	"WHERE id_mot_cle = ".Cel::db()->proteger($id_mot_cle)."), ".
53
		            "'%')";
54
 
2043 aurelien 55
		$ids_enfants = Cel::db()->executerRequete($requete.' -- '.__FILE__.':'.__LINE__);
2042 aurelien 56
 
57
		return $ids_enfants;
58
	}
59
 
60
	public function insererParChemin($mot_cle, $chemin_parent, $id_utilisateur) {
2026 aurelien 61
		$chemin_mot_cle = self::getCheminHarmonise($chemin_parent, $mot_cle);
2025 aurelien 62
 
2032 aurelien 63
		$requete = "INSERT IGNORE INTO ".$this->table_mots_cles." (chemin, id_utilisateur, tag) ".
2025 aurelien 64
		           "VALUES (".
65
		           		Cel::db()->proteger($chemin_mot_cle).", ".
66
						Cel::db()->proteger($id_utilisateur).", ".
2026 aurelien 67
						Cel::db()->proteger($mot_cle)." ".
2025 aurelien 68
		           ")";
2032 aurelien 69
 
2025 aurelien 70
		$insertion = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
2042 aurelien 71
		$resultat = false;
72
		if($insertion !== false) {
73
			$resultat = Cel::db()->obtenirDernierId();
74
		}
2025 aurelien 75
 
2042 aurelien 76
		return $resultat;
2025 aurelien 77
	}
78
 
2042 aurelien 79
	public function insererParIdParent($mot_cle, $id_parent, $id_utilisateur) {
2025 aurelien 80
		$mot_cle_simp = self::simplifier($mot_cle);
81
 
2042 aurelien 82
		if($id_parent != "") {
83
			$sous_requete_chemin = "(SELECT chemin FROM ".$this->table_mots_cles." ctp ".
84
			                       "WHERE ctp.id_mot_cle = ".Cel::db()->proteger($id_parent).")";
85
		} else {
86
			$sous_requete_chemin = Cel::db()->proteger("/");
87
		}
2025 aurelien 88
 
2042 aurelien 89
		$requete = "INSERT INTO ".$this->table_mots_cles."(chemin, id_utilisateur, mot_cle) ".
2025 aurelien 90
		           "VALUES (".
2032 aurelien 91
						"CONCAT(".$sous_requete_chemin.",".Cel::db()->proteger($mot_cle_simp).",'/'), ".
2025 aurelien 92
						Cel::db()->proteger($id_utilisateur).", ".
2032 aurelien 93
						Cel::db()->proteger($mot_cle)." ".
2025 aurelien 94
		           ")";
2045 aurelien 95
 
2025 aurelien 96
		$insertion = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
97
 
2042 aurelien 98
		if($insertion !== false) {
99
			$resultat = Cel::db()->obtenirDernierId();
100
		}
101
 
102
		return $resultat;
2025 aurelien 103
	}
104
 
2032 aurelien 105
	public function lierParId($id_mot_cle, $id_element_lie) {
106
 
2042 aurelien 107
		$requete = "INSERT INTO ".$this->table_liaison." (id_element_lie, id_mot_cle) ".
2025 aurelien 108
					"VALUES (".
2032 aurelien 109
				   		Cel::db()->proteger($id_element_lie).", ".
110
				   		Cel::db()->proteger($id_mot_cle)." ".
2025 aurelien 111
				   	") ".
2032 aurelien 112
					"ON DUPLICATE KEY UPDATE id_element_lie = id_element_lie ";
2025 aurelien 113
 
114
		$liaison = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
115
 
116
		return $liaison;
117
	}
118
 
2032 aurelien 119
	public function lierParChemin($chemin, $id_element_lie, $id_utilisateur) {
120
 
2042 aurelien 121
		$sous_requete_chemin = '(SELECT id_mot_cle FROM '.$this->table_mots_cles.' '.
2032 aurelien 122
								'WHERE chemin = '.Cel::db()->proteger(self::harmoniserChemin($chemin)).' '.
123
								'AND id_utilisateur = '.Cel::db()->proteger($id_utilisateur).' '.
124
								')';
125
 
2042 aurelien 126
		$requete = "INSERT INTO ".$this->table_liaison." (id_element_lie, id_mot_cle) ".
2025 aurelien 127
					"VALUES (".
2032 aurelien 128
						Cel::db()->proteger($id_element_lie).", ".
129
						$sous_requete_chemin." ".
2025 aurelien 130
				   	") ".
2032 aurelien 131
					"ON DUPLICATE KEY UPDATE id_element_lie = id_element_lie ";
2025 aurelien 132
 
133
		$liaison = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
134
 
135
		return $liaison;
136
	}
137
 
2042 aurelien 138
	public function lierParTableaux($ids_mots_cles, $ids_elements_lies, $id_utilisateur) {
2045 aurelien 139
 
2042 aurelien 140
		foreach($ids_mots_cles as $id_mot_cle) {
141
			foreach($ids_elements_lies as $id_element_lie) {
142
				$combinaisons[] = '('.
143
				                  	Cel::db()->proteger($id_element_lie).', '.
144
									Cel::db()->proteger($id_mot_cle).
145
									')';
146
			}
147
		}
148
 
149
		$requete = "INSERT INTO ".$this->table_liaison." (id_element_lie, id_mot_cle) ".
150
						"VALUES ".
151
							implode(',', $combinaisons).' '.
152
						"ON DUPLICATE KEY UPDATE id_element_lie = id_element_lie ";
153
		$liaison = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
2032 aurelien 154
 
2042 aurelien 155
		return $liaison;
156
	}
157
 
158
	public function supprimerLiaisonsMotsCles($ids_mots_cles, $ids_elements_lies, $id_utilisateur) {
159
 
160
		$requete = 'DELETE FROM '.$this->table_liaison.' WHERE ';
161
		$combinaisons = array();
162
		foreach($ids_mots_cles as $id_mot_cle) {
163
			foreach($ids_elements_lies as $id_element_lie) {
164
				$combinaisons[] = '('.
165
				                  	'id_element_lie = '.Cel::db()->proteger($id_element_lie).' AND '.
166
									'id_mot_cle = '.Cel::db()->proteger($id_mot_cle).
167
									')';
168
			}
169
		}
170
		$requete .= implode(' OR ', $combinaisons);
171
		$suppression = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
172
 
173
		return $suppression;
174
	}
175
 
176
	public function supprimerToutesLiaisonsPourIdsElementsLies($ids_elements_lies, $id_utilisateur) {
177
		foreach($ids_elements_lies as &$id_element_lie) {
178
			$id_element_lie = Cel::db()->proteger($id_element_lie);
179
		}
180
		$requete = 'DELETE FROM '.$this->table_liaison.' '.
181
		           'WHERE id_element_lie IN ('.implode(',', $ids_elements_lies).')';
182
 
183
		$suppression = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
2043 aurelien 184
		$suppression = ($suppression !== false);
2042 aurelien 185
		return $suppression;
186
	}
187
 
188
	public function supprimerToutesLiaisonsIdsMotsCles($ids_mots_cles, $id_utilisateur) {
189
 
2043 aurelien 190
		if(!empty($ids_mots_cles)) {
191
			$ids_mots_cles_p = array();
192
			foreach($ids_mots_cles as $id_mot_cle) {
193
				$id_mot_cle = Cel::db()->proteger($id_mot_cle);
194
			}
195
			$requete = 'DELETE FROM '.$this->table_liaison.' '.
196
					           'WHERE id_mot_cle IN ('.implode(',', $ids_mots_cles).') ';
197
 
198
			$suppression = Cel::db()->executerRequeteSimple($requete.' -- '.__FILE__.':'.__LINE__);
199
			$suppression = ($suppression !== false);
200
		} else {
201
			$suppression = true;
2042 aurelien 202
		}
203
		return $suppression;
204
	}
205
 
2046 aurelien 206
	public function supprimerLiaisonPourMotCleEtIdElementLie($mot_cle, $id_element_lie, $id_utilisateur) {
207
		// supprime toutes les laisons pour un utilisateur et un mot clé (au sens textuel) donnés
208
		$requete = "DELETE FROM ".$this->table_liaison." ".
209
					"WHERE id_element_lie = ".Cel::db()->proteger($id_element_lie)." ".
210
					"AND id_mot_cle IN (".
211
						"SELECT id_mot_cle FROM ".$this->table_mots_cles." ".
212
						"WHERE mot_cle = ".Cel::db()->proteger($mot_cle)." ".
213
						"AND id_utilisateur = ".Cel::db()->proteger($id_utilisateur)." ".
214
					")";
215
 
216
		$suppression_liaison = Cel::db()->executerRequeteSimple($requete.' -- '.__FILE__.':'.__LINE__);
217
		$suppression_liaison = ($suppression_liaison !== false);
218
 
219
		return $suppression_liaison;
220
	}
221
 
2042 aurelien 222
	public function renommerMotCle($id_mot_cle, $nouveau_nom) {
223
 
224
		$requete_ancien_chemin = 'SELECT chemin, id_utilisateur FROM '.$this->table_mots_cles.' '.
225
								  'WHERE id_mot_cle = '.Cel::db()->proteger($id_mot_cle);
226
		$res_ancien_chemin = Cel::db()->requeter($requete_ancien_chemin.' -- '.__FILE__.':'.__LINE__);
227
 
228
		$ancien_chemin = $res_ancien_chemin[0]['chemin'];
229
		$id_utilisateur = $res_ancien_chemin[0]['id_utilisateur'];
230
 
231
		$tab_chemin = explode('/', $ancien_chemin);
232
 
233
		// le dernier élément du tableau est vide (à cause du / terminal)
234
		// c'est également le cas pour le premier (à cause du / qui commence le chemin)
235
		$tab_chemin[count($tab_chemin) - 2] = $nouveau_nom;
236
		$nouveau_chemin = implode('/', $tab_chemin);
237
 
238
		$requete = 'UPDATE '.$this->table_mots_cles.' '.
239
		            'SET mot_cle = '.Cel::db()->proteger($nouveau_nom).' '.
240
		            'WHERE id_mot_cle = '.Cel::db()->proteger($id_mot_cle).' ';
241
 
242
		$renommage = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
243
 
244
		$this->renommerChemin($ancien_chemin, $nouveau_chemin, $id_utilisateur);
245
 
2045 aurelien 246
		$ids_elements_lies = $this->obtenirIdElementsLiesPourIds(array($id_mot_cle));
247
		foreach($ids_elements_lies as $id_element_lie) {
248
			self::regenererIndexTexteMotCle($id_element_lie['id_element_lie'], $this->mode);
249
		}
250
 
2042 aurelien 251
		return $renommage;
252
	}
253
 
254
	public function deplacerMotCle($id_mot_cle, $id_pere, $id_utilisateur) {
255
 
256
		$selection_chemin_pere = 'SELECT chemin FROM '.$this->table_mots_cles.' '.
257
								 'WHERE id_mot_cle = '.Cel::db()->proteger($id_pere);
258
 
259
		$chemin_pere = Cel::db()->requeter($selection_chemin_pere.' -- '.__FILE__.':'.__LINE__);
260
		$chemin_pere = $chemin_pere[0]['chemin'];
261
 
262
		$selection_infos_mot_cle = 'SELECT chemin, mot_cle FROM '.$this->table_mots_cles.' '.
263
										 'WHERE id_mot_cle = '.Cel::db()->proteger($id_mot_cle);
264
 
265
		$infos_mot_cle = Cel::db()->requeter($selection_infos_mot_cle.' -- '.__FILE__.':'.__LINE__);
266
		$ancien_chemin = $infos_mot_cle[0]['chemin'];
267
 
268
		$nouveau_chemin = $chemin_pere.'/'.$infos_mot_cle[0]['mot_cle'];
269
 
270
		return $this->renommerChemin($ancien_chemin, $nouveau_chemin, $id_utilisateur);
271
	}
272
 
2025 aurelien 273
	public function renommerChemin($ancien_chemin, $nouveau_chemin, $id_utilisateur) {
2026 aurelien 274
 
275
		$ancien_chemin = self::harmoniserChemin($ancien_chemin);
276
		$nouveau_chemin = self::harmoniserChemin($nouveau_chemin);
277
 
278
		$ancien_chemin_p = Cel::db()->proteger($ancien_chemin);
279
		$nouveau_chemin_p = Cel::db()->proteger($nouveau_chemin);
280
 
2042 aurelien 281
		$condition_chemin = Cel::db()->proteger($ancien_chemin.'%');
282
 
2026 aurelien 283
		$requete = "UPDATE ".$this->table_mots_cles." ".
2042 aurelien 284
						       	   "SET chemin = REPLACE(chemin,".$ancien_chemin_p.", ".$nouveau_chemin_p.") ".
285
								   "WHERE chemin LIKE ".$condition_chemin." AND ".
286
						           "id_utilisateur = ".$id_utilisateur." ";
2032 aurelien 287
 
2042 aurelien 288
		return Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
2025 aurelien 289
	}
290
 
291
	public function supprimerChemin($chemin, $id_utilisateur) {
292
		// TODO : triggers pour les tables liées ?
293
		$requete = "DELETE FROM ".$this->$table_mots_cles." ".
294
                   	"WHERE chemin LIKE ".Cel::db()->proteger($chemin."%")." AND ".
295
                   	"id_utilisateur = ".Cel::db()->proteger($id_utilisateur)." ";
296
 
2042 aurelien 297
		return Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
298
	}
299
 
2043 aurelien 300
	public function supprimerMotCleParId($id_mot_cle, $id_utilisateur) {
301
		//TODO: simplifier cette fonction
302
 
303
		// suppression des associations du mots clé aux images ou obs, mais aussi des associations de ses enfants
304
		// (car ceux-ci seront supprimés aussi dans le processus)
305
		// même s'il n'a pas d'enfants, le tableau contient au moins l'id du mot clé lui même
306
		$ids_mot_cle_et_enfants = $this->obtenirIdsMotsClesParIdParent($id_utilisateur, $id_mot_cle);
307
 
308
		$print = array();
309
 
310
		// obtention des ids des éléments liés au mot clé ainsi qu'à ces enfants (afin de pouvoir
311
		// régénérer les index texte de mots clés sur les éléments liés
312
		$ids_a_delier = array();
313
		foreach($ids_mot_cle_et_enfants as $id) {
314
			$ids_a_delier[] = $id['id_mot_cle'];
315
		}
316
 
317
		$ids_elements_lies = $this->obtenirIdElementsLiesPourIds($ids_a_delier);
318
		$suppression_liaison = $this->supprimerToutesLiaisonsIdsMotsCles($ids_a_delier, $id_utilisateur);
319
 
320
		foreach($ids_elements_lies as $id_element_lie) {
321
			self::regenererIndexTexteMotCle($id_element_lie['id_element_lie'], $this->mode);
322
		}
323
 
324
		// suppression du mot clé proprement dit ainsi que de ses enfants
325
		$suppression = $this->supprimerMotCleEtEnfantsParId($id_mot_cle, $id_utilisateur);
326
 
327
		return $suppression && $suppression_liaison;
328
	}
329
 
2042 aurelien 330
	public function supprimerMotCleEtEnfantsParId($id_mot_cle, $id_utilisateur) {
2025 aurelien 331
 
2042 aurelien 332
		$selection_chemin = 'SELECT chemin FROM '.$this->table_mots_cles.' '.
333
										 'WHERE id_mot_cle = '.Cel::db()->proteger($id_mot_cle);
334
		$chemin = Cel::db()->requeter($selection_chemin.' -- '.__FILE__.':'.__LINE__);
335
 
2043 aurelien 336
		$suppression = true;
2045 aurelien 337
		// vérification pour empecher la suppression accidentelle de tout l'arbre, cas qui ne devrait arriver
338
		if(!empty($chemin) && $chemin != "/") {
2043 aurelien 339
			$chemin = $chemin[0]['chemin'];
340
			$requete = "DELETE FROM ".$this->table_mots_cles." WHERE chemin LIKE ".
341
						Cel::db()->proteger($chemin.'%')." ".
342
			           	"AND id_utilisateur =".Cel::db()->proteger($id_utilisateur);
2045 aurelien 343
 
2043 aurelien 344
			$suppression = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
345
		}
2042 aurelien 346
 
2043 aurelien 347
		return ($suppression !== false);
2042 aurelien 348
 
2025 aurelien 349
	}
350
 
2046 aurelien 351
	public function obtenirIdElementsLiesPourChemins($chemins, $id_utilisateur) {
2042 aurelien 352
		foreach($chemins as &$chemin) {
353
			$chemin = Cel::db()->proteger(self::harmoniserChemin($chemin));
354
		}
355
 
356
		$requete = 'SELECT id_element_lie FROM '.$this->table_liaison.' cl '.
357
		            'INNER JOIN '.$this->table_mots_cles.' cm '.
2046 aurelien 358
		            'ON cm.id_mot_cle = cl.id_mot_cle AND chemin IN ('.implode(',', $chemin).') '.
359
		            ' AND cm.id_utilisateur = '.Cel::db()->proteger($id_utilisateur);
2042 aurelien 360
 
361
		$ids_pour_chemin = Cel::db()->executer($requete.' -- '.__FILE__.':'.__LINE__);
362
 
363
		return $ids_pour_chemin;
364
	}
365
 
366
	public function obtenirIdElementsLiesPourIds($ids_mots_cles) {
2043 aurelien 367
		$ids_elements_lies = array();
368
		if(!empty($ids_mots_cles)) {
369
			foreach($ids_mots_cles as $id_mot_cle) {
370
				$id_mot_cle = Cel::db()->proteger($id_mot_cle);
371
			}
372
 
373
			$requete = 'SELECT id_element_lie FROM '.$this->table_liaison.' '.
374
				            'WHERE id_mot_cle IN ('.implode(',', $ids_mots_cles).')';
375
 
376
			$ids_elements_lies = Cel::db()->executerRequete($requete.' -- '.__FILE__.':'.__LINE__);
2042 aurelien 377
		}
378
 
379
		return $ids_elements_lies;
380
	}
381
 
2043 aurelien 382
	public static function regenererIndexTexteMotCle($id_element_lie, $mode) {
383
		$sous_requete_concat = '('.sprintf(GestionMotsClesChemin::obtenirTemplateRequeteMotsClesTexte($mode),
384
		Cel::db()->proteger($id_element_lie)).')';
385
 
386
		list($table, $champ_id) = self::getNomTablesEtChampsElementsLies($mode);
387
		$requete = 'UPDATE '.$table.' SET mots_cles_texte = '.$sous_requete_concat.' '.
388
				           'WHERE '.$champ_id.' = '.Cel::db()->proteger($id_element_lie).' ';
389
 
390
		return Cel::db()->executer($requete, __FILE__ , __LINE__);
391
	}
392
 
393
	private static function getNomTablesEtChampsElementsLies($mode) {
394
		$tables = array();
395
		if($mode == 'obs') {
396
			$tables = array('cel_obs','id_observation');
397
		} else {
398
			$tables = array('cel_images','id_image');
399
		}
400
		return $tables;
401
	}
402
 
2042 aurelien 403
	public static function obtenirTemplateRequeteMotsClesTexte($mode) {
404
 
405
		if($mode == 'obs') {
406
			$table_liaison = 'cel_mots_cles_obs_liaison';
407
			$table_mots_cles = 'cel_arbre_mots_cles_obs';
408
		} else {
409
			$table_liaison = 'cel_mots_cles_images_liaison';
410
			$table_mots_cles = 'cel_arbre_mots_cles_images';
411
		}
412
 
413
		// renvoie un template de requete pour selectionner la concatenation
414
		// de mots clé pour un element donné (utilisable avec sprintf)
415
		return 'SELECT GROUP_CONCAT(mot_cle) '.
416
					'FROM '.$table_mots_cles.' cm '.
417
					'INNER JOIN '.$table_liaison.' cml '.
418
					'ON cml.id_mot_cle = cm.id_mot_cle '.
419
					'AND cml.id_element_lie = %s ';
420
	}
421
 
2025 aurelien 422
	// Fonctions utilitaires
423
	static public function comparerProfNoeuds($a, $b) {
424
 
425
		$nb_slashs_a = substr_count($a['chemin'], '/');
426
		$nb_slashs_b = substr_count($a['chemin'], '/');
427
		$cmp = 0;
428
 
429
		if($nb_slashs_a == $nb_slashs_b) {
430
			$cmp = strcmp($a['chemin'], $b['chemin']);
431
		} else {
432
			$cmp = ($a['chemin'] > $b['chemin']) ? +1 : -1;
433
		}
434
 
435
		return $cmp;
436
	}
437
 
2026 aurelien 438
	static public function getCheminHarmonise($chemin_parent, $mot_cle) {
439
		return self::harmoniserChemin($chemin_parent.'/'.self::simplifier($mot_cle).'/');
440
	}
441
 
442
	static public function harmoniserChemin($chemin) {
443
		$chemin = self::startsWith($chemin,'/') ? $chemin : '/'.$chemin;
444
		$chemin = self::endsWith($chemin,'/') ? $chemin : $chemin.'/';
445
		return str_replace('//', '/', $chemin);
446
	}
447
 
2025 aurelien 448
	// fonction de slugification du mot clé
449
	// http://stackoverflow.com/questions/2955251/php-function-to-make-slug-url-string
450
	static public function simplifier($text)
451
	{
2026 aurelien 452
		return trim(str_replace(array('\\','/'), '', $text));
2025 aurelien 453
		// replace non letter or digits by -
454
		$text = preg_replace('~[^\\pL\d]+~u', '-', $text);
455
 
456
		// trim
457
		$text = trim($text, '-');
458
 
459
		// transliterate
460
		$text = iconv('utf-8', 'us-ascii//TRANSLIT', $text);
461
 
462
		// lowercase
463
		$text = strtolower($text);
464
 
465
		// remove unwanted characters
466
		$text = preg_replace('~[^-\w]+~', '', $text);
467
 
468
		if (empty($text))
469
		{
470
			return 'n-a';
471
		}
472
 
473
		return $text;
474
	}
2026 aurelien 475
 
476
	static public function startsWith($haystack, $needle) {
477
		return $needle === "" || strpos($haystack, $needle) === 0;
478
	}
479
 
480
	static public function endsWith($haystack, $needle) {
481
		return $needle === "" || substr($haystack, -strlen($needle)) === $needle;
482
	}
2025 aurelien 483
}
484
?>