Moteur de recherche orienté objet en PHP 7 et PHP 8

                    

                    

                    
<?php
/*------------------------------*/
/*
 Titre : Moteur de recherche orienté objet en PHP 7 et PHP 8                                                           
                                                                                                                          
 Auteur           : R@f                                                                                                   
 Date édition     : 24 Jan 2009                                                                                        
 Date mise a jour : 18 Sept 2019
                                                                                         
 Rapport de la maj:                                                                                                       
  - fonctionnement du code vérifié                                                                                  
 Date mise a jour : 29 Mars 2026
                                                                                         
 Rapport de la maj:                                                                                                       
  - refactoring du code en PHP 7                                                                                          
  - refactoring du code en PHP 8                                                                                          
  - modification de la description                                                                                        
*/
/*------------------------------*/?>
/* FORMULAIRE */
<form action="" method="post">
    <input type="text" name="search_text" size="100" style="font-size: 12px;"
           value="<?php echo htmlspecialchars($search ?? '', ENT_QUOTES) ?>
"><br><br>

    <input type="radio" name="search_option" value="all" style="border: none;
 font-size: 12px;" checked>
    Rechercher tous les mots<br>

    <input type="radio" name="search_option" value="one" style="border: none;
 font-size: 12px;">
    Rechercher un de ces mots<br>

    <input type="radio" name="search_option" value="sentence" style="border:
 none; font-size: 12px;">
    Rechercher l'expression exacte<br><br>

    <input type="submit" value="Rechercher" name="submit" style="font-size:
 12px; position: relative; left: 20px;">
</form>

/* CLASS */
<?php
class dbSearch
{
    private array $words = [];
    private string $sep = '';
    private int $option = 0;           
// 0 = phrase exacte, 1 = ALL (ET), 2 = ONE (OU)
    private int $count_words = 0;
    private string $query_where = '';

    /**
     * Constructeur
     *
     * @param string $search_option  'all', 'one' ou 'sentence'
     * @param string $search_text    Texte saisi par l'utilisateur
     */
    public function __construct(string $search_option, string $search_text)
    {
        $search_text = trim($search_text);

        $this->option = match ($search_option) {
            'all'       => 1,
            'one'       => 2,
            default     => 0,   // phrase exacte
        };

        if ($this->option === 1 || $this->option === 2) {
            // Recherche mot par mot
            $this->sep = ($this->option === 1) ? ' AND ' : ' OR ';
            $this->words = array_filter(array_map('trim', explode(' ', 
$search_text)));
            $this->count_words = count($this->words);
        } else {
            // Phrase exacte
            $this->words = [$search_text];
            $this->count_words = 1;
        }
    }

    /**
     * Génère les requêtes SELECT et COUNT
     *
     * @param string       $table        Nom de la table
     * @param string|array $select       Champs à sélectionner

     * @param array|string $champs       Champs dans lesquels effectuer la recherche
     * @param string       $order        Champ pour ORDER BY (vide = pas de tri)
     * @param string       $sens         'ASC' ou 'DESC'
     * @param int          $limit_start
     * @param int          $limit_nb     0 = pas de LIMIT
     * @return array ['select' => ..., 'count' => ...]
     */
    public function mkQuery(
        string $table,
        string|array $select,
        array|string $champs,
        string $order = '',
        string $sens = 'DESC',
        int $limit_start = 0,
        int $limit_nb = 0
    ): array {

        if (!is_array($select)) {
            $select = [$select];
        }
        $select_str = implode(', ', $select);

        if (!is_array($champs)) {
            $champs = [$champs];
        }

        $this->query_where = $this->buildWhereClause($champs);

        $sql_select = 
"SELECT {$select_str} FROM {$table} WHERE {$this->query_where}";
        $sql_count  = "SELECT COUNT(*) FROM {$table} WHERE {$this->query_where}"
;

        if (!empty($order)) {
            $sens = strtoupper($sens) === 'ASC' ? 'ASC' : 'DESC';
            $sql_select .= " ORDER BY {$order} {$sens}";
        }

        if ($limit_nb > 0) {
            $sql_select .= " LIMIT {$limit_start}, {$limit_nb}";
        }

        $this->query_where = $sql_select; 
// pour compatibilité avec l'ancien getQuery()

        return [
            'select' => $sql_select,
            'count'  => $sql_count
        ];
    }

    /**
     * Construit la clause WHERE
     */
    private function buildWhereClause(array $champs): string
    {
        $where_parts = [];

        if ($this->option === 0) {
            // Phrase exacte
            foreach ($champs as $champ) {
                $where_parts[] = "`{$champ}` LIKE '%" . $this->escapeLike($this
->words[0]) . "%'";
            }
        } else {
            // Recherche par mots (ALL ou ONE)
            foreach ($this->words as $word) {
                $field_parts = [];
                foreach ($champs as $champ) {
                    $field_parts[] = "`{$champ}` LIKE '%" . $this->escapeLike(
$word) . "%'";
                }
                $where_parts[] = '(' . implode(' OR ', $field_parts) . ')';
            }
        }

        return implode($this->sep, $where_parts);
    }

    /**
     * Échappe les caractères spéciaux pour LIKE (% et _)
     */
    private function escapeLike(string $value): string
    {
        return str_replace(['%', '_'], ['\\%', '\\_'], $value);
    }

    /**
     * Retourne la dernière clause WHERE complète (sans LIMIT)
     * Utile pour la pagination quand la recherche ne change pas.
     */
    public function getWhere(): string
    {
        return $this->query_where;
    }

    /**
     * Alias pour getWhere() (compatibilité ancienne)
     */
    public function getQuery(): string
    {
        return $this->getWhere();
    }
}
?