wktr/VoituresApi-API
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Support de la recherche par immatriculation

Browse source
This commit is contained in:
Erwann PHILIPPE 2026-09-16 11:31:01 +02:00
parent 0a6c8ec05d
commit 24c432f325
2 changed files with 150 additions and 74 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

158
index.php
View file

@ -48,40 +48,67 @@ function getBody(): array
*/ */
function getPathSegments(): array function getPathSegments(): array
{ {
// Si passé en paramètre d'URL direct (ex: ?route=/cars)
if (!empty($_GET['route'])) { if (!empty($_GET['route'])) {
$path = trim($_GET['route'], '/'); $path = trim($_GET['route'], '/');
return $path === '' ? [] : explode('/', $path); return $path === '' ? [] : explode('/', $path);
} }
// Si PATH_INFO est fourni (ex: index.php/cars)
if (!empty($_SERVER['PATH_INFO'])) { if (!empty($_SERVER['PATH_INFO'])) {
$path = trim($_SERVER['PATH_INFO'], '/'); $path = trim($_SERVER['PATH_INFO'], '/');
return $path === '' ? [] : explode('/', $path); return $path === '' ? [] : explode('/', $path);
} }
// Analyse depuis REQUEST_URI
$uri = parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH); $uri = parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH);
$scriptDir = dirname($_SERVER['SCRIPT_NAME'] ?? ''); $scriptDir = dirname($_SERVER['SCRIPT_NAME'] ?? '');
// Nettoie le préfixe du dossier du script si présent
if ($scriptDir !== '/' && $scriptDir !== '\\' && strpos($uri, $scriptDir) === 0) { if ($scriptDir !== '/' && $scriptDir !== '\\' && strpos($uri, $scriptDir) === 0) {
$uri = substr($uri, strlen($scriptDir)); $uri = substr($uri, strlen($scriptDir));
} }
// Supprime "index.php" si présent
$uri = preg_replace('#^/?index\.php#i', '', $uri); $uri = preg_replace('#^/?index\.php#i', '', $uri);
$path = trim($uri, '/'); $path = trim($uri, '/');
return $path === '' ? [] : explode('/', $path); return $path === '' ? [] : explode('/', $path);
} }
/**
* Recherche d'une voiture par sa plaque d'immatriculation (exacte ou normalisée)
*/
function findCarByPlate(PDO $db, string $plaque): void
{
$clean = strtoupper(trim(urldecode($plaque)));
$norm = str_replace(['-', ' ', '.', '_'], '', $clean);
$stmt = $db->prepare('
SELECT c.*,
(SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km
FROM cars c
WHERE UPPER(c.immatriculation) = :raw
OR REPLACE(REPLACE(REPLACE(REPLACE(UPPER(c.immatriculation), "-", ""), " ", ""), ".", ""), "_", "") = :norm
LIMIT 1
');
$stmt->execute([':raw' => $clean, ':norm' => $norm]);
$car = $stmt->fetch();
if (!$car) {
sendJson(404, [
'success' => false,
'error' => "Aucune voiture trouvée avec l'immatriculation '$clean'"
]);
}
sendJson(200, [
'success' => true,
'data' => $car
]);
}
try { try {
$db = getDB(); $db = getDB();
$method = strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET'); $method = strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET');
$segments = getPathSegments(); $segments = getPathSegments();
// Route racine: Documentation sommaire des points d'accès // Route racine: Documentation des points d'accès
if (empty($segments)) { if (empty($segments)) {
sendJson(200, [ sendJson(200, [
'success' => true, 'success' => true,
@ -89,11 +116,12 @@ try {
'database' => DB_NAME, 'database' => DB_NAME,
'endpoints' => [ 'endpoints' => [
'Voitures' => [ 'Voitures' => [
'GET /cars' => 'Liste toutes les voitures', 'GET /cars' => 'Liste toutes les voitures (filtrable par ?immatriculation=...)',
'GET /cars/{id}' => 'Détails d\'une voiture', 'GET /cars/{id}' => 'Détails d\'une voiture par ID',
'GET /cars/immatriculation/{plaque}' => 'Identifier une voiture par sa plaque d\'immatriculation',
'GET /cars/{id}/etat' => 'État complet (voiture, dernier km, entretiens, notes)', 'GET /cars/{id}/etat' => 'État complet (voiture, dernier km, entretiens, notes)',
'POST /cars' => 'Créer une voiture (marque, modele, annee, dateAchat, VIN)', 'POST /cars' => 'Créer une voiture (marque, modele, annee, dateAchat, VIN, immatriculation)',
'PUT /cars/{id}' => 'Modifier les paramètres d\'une voiture', 'PUT /cars/{id}' => 'Modifier les paramètres d\'une voiture (y compris immatriculation)',
'DELETE /cars/{id}' => 'Supprimer une voiture (et ses données associées)' 'DELETE /cars/{id}' => 'Supprimer une voiture (et ses données associées)'
], ],
'Kilométrage' => [ 'Kilométrage' => [
@ -101,7 +129,7 @@ try {
'POST /cars/{id}/kilometrage' => 'Ajouter un relevé kilométrique (valeur, date_releve)', 'POST /cars/{id}/kilometrage' => 'Ajouter un relevé kilométrique (valeur, date_releve)',
'DELETE /kilometrage/{id}' => 'Supprimer un relevé kilométrique' 'DELETE /kilometrage/{id}' => 'Supprimer un relevé kilométrique'
], ],
'Entretiens (Maintenance)' => [ 'Entretiens' => [
'GET /cars/{id}/maintenance' => 'Historique des entretiens d\'une voiture', 'GET /cars/{id}/maintenance' => 'Historique des entretiens d\'une voiture',
'POST /cars/{id}/maintenance' => 'Ajouter un entretien (type_entretien, date_evenement, kilometrage, description, prix)', 'POST /cars/{id}/maintenance' => 'Ajouter un entretien (type_entretien, date_evenement, kilometrage, description, prix)',
'PUT /maintenance/{id}' => 'Modifier un entretien', 'PUT /maintenance/{id}' => 'Modifier un entretien',
@ -119,16 +147,34 @@ try {
$resource = strtolower($segments[0]); $resource = strtolower($segments[0]);
// =========================================================================
// ENDPOINT DIRECT: /immatriculation/{plaque}
// =========================================================================
if ($resource === 'immatriculation' && $method === 'GET') {
$plaque = $segments[1] ?? null;
if (empty($plaque)) {
sendJson(400, ['success' => false, 'error' => 'Numéro d\'immatriculation manquant dans l\'URL']);
}
findCarByPlate($db, $plaque);
}
// ========================================================================= // =========================================================================
// RESSOURCE: CARS (/cars ...) // RESSOURCE: CARS (/cars ...)
// ========================================================================= // =========================================================================
if ($resource === 'cars' || $resource === 'voitures') { if ($resource === 'cars' || $resource === 'voitures') {
// NOUVEAU ENDPOINT: GET /cars/immatriculation/{plaque}
if (isset($segments[1]) && strtolower($segments[1]) === 'immatriculation' && $method === 'GET') {
$plaque = $segments[2] ?? null;
if (empty($plaque)) {
sendJson(400, ['success' => false, 'error' => 'Numéro d\'immatriculation manquant dans l\'URL']);
}
findCarByPlate($db, $plaque);
}
$carId = isset($segments[1]) && is_numeric($segments[1]) ? (int)$segments[1] : null; $carId = isset($segments[1]) && is_numeric($segments[1]) ? (int)$segments[1] : null;
$subResource = $segments[2] ?? null; $subResource = $segments[2] ?? null;
// --- SOUS-RESSOURCES DE CARS --- // 1. GET /cars/{id}/etat (État complet via la procédure sp_getEtatVoiture)
// 1. /cars/{id}/etat (État complet via la procédure sp_getEtatVoiture)
if ($carId && $subResource === 'etat' && $method === 'GET') { if ($carId && $subResource === 'etat' && $method === 'GET') {
try { try {
$stmt = $db->prepare('CALL sp_getEtatVoiture(:id)'); $stmt = $db->prepare('CALL sp_getEtatVoiture(:id)');
@ -159,7 +205,6 @@ try {
] ]
]); ]);
} catch (Exception $e) { } catch (Exception $e) {
// Fallback si la procédure stockée a un souci
$stmtCar = $db->prepare(' $stmtCar = $db->prepare('
SELECT c.*, SELECT c.*,
(SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km (SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km
@ -312,10 +357,14 @@ try {
sendJson(405, ['success' => false, 'error' => 'Méthode non autorisée pour cette sous-ressource']); sendJson(405, ['success' => false, 'error' => 'Méthode non autorisée pour cette sous-ressource']);
} }
// --- OPÉRATIONS PRINCIPALES SUR LES VOITURES (/cars ou /cars/{id}) --- // --- ACTIONS PRINCIPALES SUR LES VOITURES ---
// GET /cars : Liste toutes les voitures (ou filtre ?immatriculation=...)
if ($carId === null && $subResource === null && $method === 'GET') {
if (!empty($_GET['immatriculation'])) {
findCarByPlate($db, (string)$_GET['immatriculation']);
}
// GET /cars : Liste toutes les voitures
if ($carId === null && $method === 'GET') {
$sql = 'SELECT c.*, $sql = 'SELECT c.*,
(SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km (SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km
FROM cars c FROM cars c
@ -344,7 +393,6 @@ try {
if ($carId === null && $method === 'POST') { if ($carId === null && $method === 'POST') {
$body = getBody(); $body = getBody();
// Validation des champs obligatoires
$required = ['marque', 'modele', 'annee', 'dateAchat']; $required = ['marque', 'modele', 'annee', 'dateAchat'];
foreach ($required as $field) { foreach ($required as $field) {
if (empty($body[$field])) { if (empty($body[$field])) {
@ -357,34 +405,51 @@ try {
$annee = (int)$body['annee']; $annee = (int)$body['annee'];
$dateAchat = (string)$body['dateAchat']; $dateAchat = (string)$body['dateAchat'];
$vin = !empty($body['VIN']) ? trim((string)$body['VIN']) : null; $vin = !empty($body['VIN']) ? trim((string)$body['VIN']) : null;
$immatriculation = !empty($body['immatriculation']) ? strtoupper(trim((string)$body['immatriculation'])) : null;
// Utilisation de la procédure stockée sp_insertVoiture // Vérifier unicité de l'immatriculation si renseignée
if ($immatriculation !== null) {
$normImmat = str_replace(['-', ' ', '.', '_'], '', $immatriculation);
$stmtCheck = $db->prepare('
SELECT id FROM cars
WHERE UPPER(immatriculation) = :raw
OR REPLACE(REPLACE(REPLACE(REPLACE(UPPER(immatriculation), "-", ""), " ", ""), ".", ""), "_", "") = :norm
');
$stmtCheck->execute([':raw' => $immatriculation, ':norm' => $normImmat]);
if ($stmtCheck->fetch()) {
sendJson(409, [
'success' => false,
'error' => "L'immatriculation '$immatriculation' est déjà utilisée pour un autre véhicule."
]);
}
}
// Appel de la procédure stockée sp_insertVoiture
try { try {
$stmt = $db->prepare('CALL sp_insertVoiture(:marque, :modele, :annee, :dateAchat, :vin)'); $stmt = $db->prepare('CALL sp_insertVoiture(:marque, :modele, :annee, :dateAchat, :vin, :immatriculation)');
$stmt->execute([ $stmt->execute([
':marque' => $marque, ':marque' => $marque,
':modele' => $modele, ':modele' => $modele,
':annee' => $annee, ':annee' => $annee,
':dateAchat' => $dateAchat, ':dateAchat' => $dateAchat,
':vin' => $vin ':vin' => $vin,
':immatriculation' => $immatriculation
]); ]);
$res = $stmt->fetch(); $res = $stmt->fetch();
$stmt->closeCursor(); $stmt->closeCursor();
$newId = isset($res['new_id']) ? (int)$res['new_id'] : (int)$db->lastInsertId(); $newId = isset($res['new_id']) ? (int)$res['new_id'] : (int)$db->lastInsertId();
} catch (Exception $e) { } catch (Exception $e) {
// Fallback direct INSERT si la procédure a une incompatibilité $stmt = $db->prepare('INSERT INTO cars (marque, modele, annee, dateAchat, VIN, immatriculation) VALUES (?, ?, ?, ?, ?, ?)');
$stmt = $db->prepare('INSERT INTO cars (marque, modele, annee, dateAchat, VIN) VALUES (?, ?, ?, ?, ?)'); $stmt->execute([$marque, $modele, $annee, $dateAchat, $vin, $immatriculation]);
$stmt->execute([$marque, $modele, $annee, $dateAchat, $vin]);
$newId = (int)$db->lastInsertId(); $newId = (int)$db->lastInsertId();
} }
// Si un kilométrage initial est fourni // Kilométrage initial optionnel
if (!empty($body['kilometrage_initial'])) { if (!empty($body['kilometrage_initial'])) {
$kmStmt = $db->prepare('INSERT INTO kilometrage (car_id, date_releve, valeur) VALUES (?, ?, ?)'); $kmStmt = $db->prepare('INSERT INTO kilometrage (car_id, date_releve, valeur) VALUES (?, ?, ?)');
$kmStmt->execute([$newId, $dateAchat, (int)$body['kilometrage_initial']]); $kmStmt->execute([$newId, $dateAchat, (int)$body['kilometrage_initial']]);
} }
// Récupère l'enregistrement créé
$stmtGet = $db->prepare(' $stmtGet = $db->prepare('
SELECT c.*, SELECT c.*,
(SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km (SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km
@ -402,7 +467,6 @@ try {
// PUT / PATCH /cars/{id} : Mettre à jour les paramètres d'une voiture // PUT / PATCH /cars/{id} : Mettre à jour les paramètres d'une voiture
if ($carId !== null && $subResource === null && ($method === 'PUT' || $method === 'PATCH')) { if ($carId !== null && $subResource === null && ($method === 'PUT' || $method === 'PATCH')) {
// Vérifier si la voiture existe
$check = $db->prepare('SELECT id FROM cars WHERE id = ?'); $check = $db->prepare('SELECT id FROM cars WHERE id = ?');
$check->execute([$carId]); $check->execute([$carId]);
if (!$check->fetch()) { if (!$check->fetch()) {
@ -410,10 +474,30 @@ try {
} }
$body = getBody(); $body = getBody();
$allowedFields = ['marque', 'modele', 'annee', 'dateAchat', 'VIN']; $allowedFields = ['marque', 'modele', 'annee', 'dateAchat', 'VIN', 'immatriculation'];
$updates = []; $updates = [];
$params = []; $params = [];
// Si immatriculation modifiée, vérifier unicité
if (!empty($body['immatriculation'])) {
$immat = strtoupper(trim((string)$body['immatriculation']));
$body['immatriculation'] = $immat;
$normImmat = str_replace(['-', ' ', '.', '_'], '', $immat);
$stmtCheck = $db->prepare('
SELECT id FROM cars
WHERE (UPPER(immatriculation) = :raw
OR REPLACE(REPLACE(REPLACE(REPLACE(UPPER(immatriculation), "-", ""), " ", ""), ".", ""), "_", "") = :norm)
AND id != :id
');
$stmtCheck->execute([':raw' => $immat, ':norm' => $normImmat, ':id' => $carId]);
if ($stmtCheck->fetch()) {
sendJson(409, [
'success' => false,
'error' => "L'immatriculation '$immat' est déjà utilisée pour un autre véhicule."
]);
}
}
foreach ($allowedFields as $field) { foreach ($allowedFields as $field) {
if (array_key_exists($field, $body)) { if (array_key_exists($field, $body)) {
$updates[] = "`$field` = ?"; $updates[] = "`$field` = ?";
@ -430,7 +514,6 @@ try {
$stmt = $db->prepare($sql); $stmt = $db->prepare($sql);
$stmt->execute($params); $stmt->execute($params);
// Récupère la voiture mise à jour
$stmtGet = $db->prepare(' $stmtGet = $db->prepare('
SELECT c.*, SELECT c.*,
(SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km (SELECT valeur FROM kilometrage WHERE car_id = c.id ORDER BY date_releve DESC, id DESC LIMIT 1) AS dernier_km
@ -448,14 +531,12 @@ try {
// DELETE /cars/{id} : Supprimer une voiture // DELETE /cars/{id} : Supprimer une voiture
if ($carId !== null && $subResource === null && $method === 'DELETE') { if ($carId !== null && $subResource === null && $method === 'DELETE') {
// Vérifier existence
$check = $db->prepare('SELECT id FROM cars WHERE id = ?'); $check = $db->prepare('SELECT id FROM cars WHERE id = ?');
$check->execute([$carId]); $check->execute([$carId]);
if (!$check->fetch()) { if (!$check->fetch()) {
sendJson(404, ['success' => false, 'error' => "Voiture #{$carId} introuvable"]); sendJson(404, ['success' => false, 'error' => "Voiture #{$carId} introuvable"]);
} }
// Exécution de la procédure stockée sp_deleteVoiture
try { try {
$stmt = $db->prepare('CALL sp_deleteVoiture(:id)'); $stmt = $db->prepare('CALL sp_deleteVoiture(:id)');
$stmt->execute([':id' => $carId]); $stmt->execute([':id' => $carId]);
@ -493,7 +574,7 @@ try {
} }
// ========================================================================= // =========================================================================
// RESSOURCE: MAINTENANCE DIRECT (/maintenance/{id}) // RESSOURCE: ENTRETIENS DIRECT (/maintenance/{id})
// ========================================================================= // =========================================================================
if ($resource === 'maintenance' || $resource === 'entretiens') { if ($resource === 'maintenance' || $resource === 'entretiens') {
$maintId = isset($segments[1]) && is_numeric($segments[1]) ? (int)$segments[1] : null; $maintId = isset($segments[1]) && is_numeric($segments[1]) ? (int)$segments[1] : null;
@ -616,20 +697,13 @@ try {
sendJson(405, ['success' => false, 'error' => "Méthode non autorisée sur /notes/{id}"]); sendJson(405, ['success' => false, 'error' => "Méthode non autorisée sur /notes/{id}"]);
} }
// Ressource inconnue
sendJson(404, [ sendJson(404, [
'success' => false, 'success' => false,
'error' => "Ressource '/$resource' non reconnue. Consultez la racine '/' pour la documentation des routes." 'error' => "Ressource '/$resource' non reconnue. Consultez la racine '/' pour la documentation des routes."
]); ]);
} catch (PDOException $e) { } catch (PDOException $e) {
sendJson(500, [ sendJson(500, ['success' => false, 'error' => 'Erreur SQL: ' . $e->getMessage()]);
'success' => false,
'error' => 'Erreur SQL: ' . $e->getMessage()
]);
} catch (Throwable $e) { } catch (Throwable $e) {
sendJson(500, [ sendJson(500, ['success' => false, 'error' => 'Erreur serveur: ' . $e->getMessage()]);
'success' => false,
'error' => 'Erreur serveur: ' . $e->getMessage()
]);
} }

16
voituresapi (1).sql
View file

@ -53,9 +53,9 @@ CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_getKilometrages` (IN `p_id` INT,
END$$ END$$
DROP PROCEDURE IF EXISTS `sp_insertVoiture`$$ DROP PROCEDURE IF EXISTS `sp_insertVoiture`$$
CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_insertVoiture` (IN `p_marque` VARCHAR(255), IN `p_modele` VARCHAR(255), IN `p_annee` INT, IN `p_dateAchat` DATE, IN `p_VIN` VARCHAR(255)) BEGIN CREATE DEFINER=`root`@`localhost` PROCEDURE `sp_insertVoiture` (IN `p_marque` VARCHAR(255), IN `p_modele` VARCHAR(255), IN `p_annee` INT, IN `p_dateAchat` DATE, IN `p_VIN` VARCHAR(255), IN `p_immatriculation` VARCHAR(20)) BEGIN
INSERT INTO cars (marque, modele, annee, dateAchat, VIN) INSERT INTO cars (marque, modele, annee, dateAchat, VIN, immatriculation)
VALUES (p_marque, p_modele, p_annee, p_dateAchat, p_VIN); VALUES (p_marque, p_modele, p_annee, p_dateAchat, p_VIN, p_immatriculation);
SELECT LAST_INSERT_ID() AS new_id; SELECT LAST_INSERT_ID() AS new_id;
END$$ END$$
@ -75,16 +75,18 @@ CREATE TABLE IF NOT EXISTS `cars` (
`annee` int NOT NULL, `annee` int NOT NULL,
`dateAchat` date NOT NULL, `dateAchat` date NOT NULL,
`VIN` varchar(17) DEFAULT NULL, `VIN` varchar(17) DEFAULT NULL,
PRIMARY KEY (`id`) `immatriculation` varchar(20) DEFAULT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `idx_immatriculation` (`immatriculation`)
) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci; ) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
-- --
-- Déchargement des données de la table `cars` -- Déchargement des données de la table `cars`
-- --
INSERT INTO `cars` (`id`, `marque`, `modele`, `annee`, `dateAchat`, `VIN`) VALUES INSERT INTO `cars` (`id`, `marque`, `modele`, `annee`, `dateAchat`, `VIN`, `immatriculation`) VALUES
(1, 'Peugeot', '207', 2009, '2025-05-20', 'VF3WA8HZCXXXXXXXX'), (1, 'Peugeot', '207', 2009, '2025-05-20', 'VF3WA8HZCXXXXXXXX', 'AB-123-CD'),
(2, 'Peugeot', '208', 2010, '2025-05-20', 'VF3WA8HZCXXXXXXXX'); (2, 'Peugeot', '208', 2010, '2025-05-20', 'VF3WA8HZCXXXXXXXX', 'EF-456-GH');
-- -------------------------------------------------------- -- --------------------------------------------------------