Risolva le collisioni di slug con un suffisso numerico

Se il valore è disponibile, lo restituisce senza modifiche. Se è già utilizzato, verifica alternative numeriche come -2, -3 e successive fino a trovare la prima libera. È un componente piccolo e deterministico per sistemi editoriali, importazioni, generatori di documentazione e qualsiasi flusso che debba assegnare un percorso URL univoco senza sostituire accidentalmente contenuti esistenti.

Conservi lo slug desiderato quando possibile

Un buon risolutore di collisioni deve modificare un URL soltanto quando è necessario. Inserisca il valore proposto in desired_slug e fornisca tutti i valori occupati in used_slugs. I confronti sono esatti e distinguono maiuscole e minuscole. Se la proposta non compare nell’insieme occupato, il risultato contiene lo slug originale e indica che non si è verificata alcuna collisione. Lo strumento non converte in minuscolo, non elimina spazi, non traslittera e non sostituisce la punteggiatura, perché tali trasformazioni appartengono alla fase precedente di creazione dello slug. Separare le responsabilità evita modifiche impreviste agli URL e rende il risultato riproducibile in build, migrazioni e test. Uno slug desiderato vuoto viene rifiutato anziché trasformato in un suffisso arbitrario, poiché ciò nasconderebbe un titolo mancante o una mappatura precedente difettosa. Le voci duplicate nell’elenco non incidono sulla risposta: vengono consolidate naturalmente durante la ricerca, senza richiedere pulizia preventiva.

Scelga il primo suffisso numerico disponibile

Quando lo slug esatto è occupato, la selezione inizia da 2, secondo la convenzione comune per cui il percorso senza suffisso rappresenta il primo elemento e quello successivo riceve -2. Il risolutore controlla quindi i candidati in ordine crescente: desiderato-2, desiderato-3, desiderato-4 e così via. Si ferma al primo candidato assente dall’insieme fornito. Gli spazi liberi vengono quindi riutilizzati in modo prevedibile. Per esempio, se report, report-2 e report-4 sono occupati, il risultato sarà report-3. Il confronto considera stringhe complete, perciò annual-report e report-old non causano collisioni. Una terminazione numerica già presente viene trattata come parte letterale del valore e non viene interpretata o riscritta: se Lei richiede release-2 ed è occupato, il primo candidato sarà release-2-2. Questo comportamento evita di presumere le intenzioni e garantisce che input identici producano sempre lo stesso output, senza dipendere da database, orologio, casualità, impostazioni locali o ordine di esecuzione.

Utilizzi il risultato in sicurezza nei flussi editoriali

Questa capacità è utile quando l’applicazione conosce già gli slug riservati. Raccolga tali valori, li invii insieme allo slug desiderato e utilizzi il risultato per il nuovo record. La risposta indica inoltre se si è verificata una collisione e, per un risultato con suffisso, quale numero è stato scelto. Questi metadati possono alimentare registri, anteprime o un messaggio che spieghi perché l’URL differisce dalla proposta iniziale. L’operazione non riserva il valore restituito: i sistemi con scritture simultanee devono comunque imporre un vincolo di unicità e riprovare con un elenco aggiornato se un altro processo acquisisce lo stesso slug. Nelle importazioni in blocco, aggiunga ogni assegnazione riuscita all’insieme locale prima di risolvere la riga successiva. Poiché il confronto è esatto, applichi prima e in modo coerente la propria politica URL, usando un generatore di slug se deve normalizzare maiuscole, Unicode, spazi o punteggiatura. Ogni richiesta API costa $0.002; la stessa logica deterministica può essere eseguita nel browser per controlli interattivi.