+
+
+id();
+ $table->string('name');
+ $table->string('email')->unique();
+ $table->string('city');
+ $table->timestamps();
+ });
+
+ // Insert sample data with Portuguese accents
+ DB::table('users')->insert([
+ ['name' => 'João Silva', 'email' => 'joao@example.com', 'city' => 'São Paulo'],
+ ['name' => 'María Santos', 'email' => 'maria@example.com', 'city' => 'Rio de Janeiro'],
+ ['name' => 'José Oliveira', 'email' => 'jose@example.com', 'city' => 'Belo Horizonte'],
+ ['name' => 'Ana Conceição', 'email' => 'ana@example.com', 'city' => 'Salvador'],
+ ['name' => 'Paulo Ribeirão', 'email' => 'paulo@example.com', 'city' => 'Ribeirão Preto'],
+ ['name' => 'Tatiane Simões', 'email' => 'tatiane@example.com', 'city' => 'João Pessoa'],
+ ['name' => 'Carlos São', 'email' => 'carlos@example.com', 'city' => 'São Luís'],
+ ]);
+ }
+
+ public function down()
+ {
+ Schema::dropIfExists('users');
+ }
+};
+
+/**
+ * Example Routes
+ */
+
+// routes/web.php
+Route::get('/users', [UserController::class, 'index'])->name('users.index');
+Route::get('/users/data', [UserController::class, 'getUsersData'])->name('users.data');
+Route::get('/cities/data', [UserController::class, 'getBrazilianCitiesData'])->name('cities.data');
+
+/**
+ * Configuration Example
+ */
+
+// config/datatables.php
+return [
+ 'search' => [
+ 'smart' => true,
+ 'multi_term' => true,
+ 'case_insensitive' => true,
+ 'use_wildcards' => false,
+ 'starts_with' => false,
+ 'ignore_accents' => true, // <-- Enable accent-insensitive search + ], + // ... rest of configuration +]; \ No newline at end of file diff --git a/src/CollectionDataTable.php b/src/CollectionDataTable.php index 4392549e..07436520 100644 --- a/src/CollectionDataTable.php +++ b/src/CollectionDataTable.php @@ -10,6 +10,7 @@ use Illuminate\Support\Arr; use Illuminate\Support\Collection; use Illuminate\Support\Str; +use Yajra\DataTables\Utilities\Helper; class CollectionDataTable extends DataTableAbstract { @@ -99,6 +100,11 @@ public function columnSearch(): void $regex = $this->request->isRegex($i);
$keyword = $this->request->columnKeyword($i);
+ // Normalize keyword for accent-insensitive search if enabled
+ if ($this->config->isIgnoreAccents()) {
+ $keyword = Helper::normalizeAccents($keyword);
+ }
+
$this->collection = $this->collection->filter(
function ($row) use ($column, $keyword, $regex) {
$data = $this->serialize($row);
@@ -106,6 +112,10 @@ function ($row) use ($column, $keyword, $regex) {
/** @var string $value */
$value = Arr::get($data, $column);
+ if ($this->config->isIgnoreAccents()) {
+ $value = Helper::normalizeAccents($value);
+ }
+
if ($this->config->isCaseInsensitive()) {
if ($regex) {
return preg_match('/'.$keyword.'/i', $value) == 1;
@@ -215,6 +225,10 @@ public function setOffset(int $offset): self
*/
protected function globalSearch(string $keyword): void
{
+ if ($this->config->isIgnoreAccents()) {
+ $keyword = Helper::normalizeAccents($keyword);
+ }
+
$keyword = $this->config->isCaseInsensitive() ? Str::lower($keyword) : $keyword;
$this->collection = $this->collection->filter(function ($row) use ($keyword) {
@@ -225,6 +239,9 @@ protected function globalSearch(string $keyword): void
if (! is_string($value)) {
continue;
} else {
+ if ($this->config->isIgnoreAccents()) {
+ $value = Helper::normalizeAccents($value);
+ }
$value = $this->config->isCaseInsensitive() ? Str::lower($value) : $value;
}
diff --git a/src/QueryDataTable.php b/src/QueryDataTable.php
index 01cd5b71..630a9b35 100644
--- a/src/QueryDataTable.php
+++ b/src/QueryDataTable.php
@@ -564,12 +564,21 @@ protected function castColumn(string $column): string
*/
protected function compileQuerySearch($query, string $column, string $keyword, string $boolean = 'or'): void
{
- $column = $this->wrap($this->addTablePrefix($query, $column));
- $column = $this->castColumn($column);
- $sql = $column.' LIKE ?';
+ // Validate inputs to prevent any potential issues
+ if (empty($column) || empty($keyword)) {
+ return;
+ }
- if ($this->config->isCaseInsensitive()) {
- $sql = 'LOWER('.$column.') LIKE ?';
+ $wrappedColumn = $this->wrap($this->addTablePrefix($query, $column));
+ $castedColumn = $this->castColumn($wrappedColumn);
+
+ if ($this->config->isIgnoreAccents()) {
+ // For accent-insensitive search, we normalize both the column and the keyword
+ $sql = $this->getNormalizeAccentsFunction($castedColumn).' LIKE ?';
+ } elseif ($this->config->isCaseInsensitive()) {
+ $sql = 'LOWER('.$castedColumn.') LIKE ?';
+ } else {
+ $sql = $castedColumn.' LIKE ?';
}
$query->{$boolean.'WhereRaw'}($sql, [$this->prepareKeyword($keyword)]);
@@ -680,6 +689,10 @@ protected function getSelectedColumns($query): array
*/
protected function prepareKeyword(string $keyword): string
{
+ if ($this->config->isIgnoreAccents()) {
+ $keyword = Helper::normalizeAccents($keyword);
+ }
+
if ($this->config->isCaseInsensitive()) {
$keyword = Str::lower($keyword);
}
@@ -699,6 +712,63 @@ protected function prepareKeyword(string $keyword): string
return $keyword;
}
+ /**
+ * Get the database function to normalize accents for the given column.
+ *
+ * @param string $column The column name (should be already wrapped/escaped)
+ * @return string SQL function to normalize accents
+ */
+ protected function getNormalizeAccentsFunction(string $column): string
+ {
+ if (empty($column)) {
+ return "LOWER('')";
+ }
+
+ $driver = $this->getConnection()->getDriverName();
+
+ switch ($driver) {
+ case 'mysql':
+ return $this->getMySqlNormalizeFunction($column);
+ case 'pgsql':
+ return $this->getPostgreSqlNormalizeFunction($column);
+ case 'sqlite':
+ return "LOWER($column)"; // SQLite doesn't have built-in accent normalization
+ default:
+ return "LOWER($column)"; // Fallback for other databases
+ }
+ }
+
+ /**
+ * Get MySQL-specific accent normalization function.
+ */
+ protected function getMySqlNormalizeFunction(string $column): string
+ {
+ // Build safe SQL with static strings - no user input, no SQL injection risk
+ $sql = "LOWER($column)";
+ $sql = "REPLACE($sql, 'ã', 'a')";
+ $sql = "REPLACE($sql, 'á', 'a')";
+ $sql = "REPLACE($sql, 'à', 'a')";
+ $sql = "REPLACE($sql, 'â', 'a')";
+ $sql = "REPLACE($sql, 'é', 'e')";
+ $sql = "REPLACE($sql, 'ê', 'e')";
+ $sql = "REPLACE($sql, 'í', 'i')";
+ $sql = "REPLACE($sql, 'ó', 'o')";
+ $sql = "REPLACE($sql, 'ô', 'o')";
+ $sql = "REPLACE($sql, 'õ', 'o')";
+ $sql = "REPLACE($sql, 'ú', 'u')";
+ $sql = "REPLACE($sql, 'ç', 'c')";
+
+ return $sql;
+ }
+
+ /**
+ * Get PostgreSQL-specific accent normalization function.
+ */
+ protected function getPostgreSqlNormalizeFunction(string $column): string
+ {
+ return "LOWER(translate($column, 'ÃãÁáÀàÂâÉéÊêÍíÓóÔôÕõÚúÇç', 'aaaaaaaeeeiioooooucc'))";
+ }
+
/**
* Add custom filter handler for the give column.
*
diff --git a/src/Utilities/Config.php b/src/Utilities/Config.php
index ae474368..7e62496e 100644
--- a/src/Utilities/Config.php
+++ b/src/Utilities/Config.php
@@ -81,6 +81,19 @@ public function isStartsWithSearch(): bool
return (bool) $this->repository->get('datatables.search.starts_with', false);
}
+ /**
+ * Check if DataTable config ignores accents when searching.
+ *
+ * When enabled, accented characters are normalized to their base letters
+ * during search operations (e.g., 'é' becomes 'e', 'ã' becomes 'a').
+ *
+ * @return bool True if accent-insensitive search is enabled
+ */
+ public function isIgnoreAccents(): bool
+ {
+ return (bool) $this->repository->get('datatables.search.ignore_accents', false);
+ }
+
public function jsonOptions(): int
{
/** @var int $options */
diff --git a/src/Utilities/Helper.php b/src/Utilities/Helper.php
index b0e87127..3eb6ab35 100644
--- a/src/Utilities/Helper.php
+++ b/src/Utilities/Helper.php
@@ -12,6 +12,44 @@
use ReflectionMethod;
class Helper
+{
+ /**
+ * Normalize accented characters to their base letter for accent-insensitive search.
+ * Only replaces Portuguese Brazilian accents as specified.
+ *
+ * @param string $value The string to normalize
+ * @return string The normalized string with accents removed
+ */
+ public static function normalizeAccents(string $value): string
+ {
+ // Return early for empty strings or strings without accents
+ if (empty($value) || ! preg_match('/[ÃãÁáÀàÂâÉéÊêÍíÓóÔôÕõÚúÇç]/', $value)) {
+ return $value;
+ }
+
+ $map = [
+ // Uppercase A variations
+ 'Ã' => 'A', 'Á' => 'A', 'À' => 'A', 'Â' => 'A',
+ // Lowercase a variations
+ 'ã' => 'a', 'á' => 'a', 'à' => 'a', 'â' => 'a',
+ // Uppercase E variations
+ 'É' => 'E', 'Ê' => 'E',
+ // Lowercase e variations
+ 'é' => 'e', 'ê' => 'e',
+ // I variations
+ 'Í' => 'I', 'í' => 'i',
+ // Uppercase O variations
+ 'Ó' => 'O', 'Ô' => 'O', 'Õ' => 'O',
+ // Lowercase o variations
+ 'ó' => 'o', 'ô' => 'o', 'õ' => 'o',
+ // U variations
+ 'Ú' => 'U', 'ú' => 'u',
+ // C variations
+ 'Ç' => 'C', 'ç' => 'c',
+ ];
+
+ return strtr($value, $map);
+ }
{
/**
* Places item of extra columns into results by care of their order.
diff --git a/src/config/datatables.php b/src/config/datatables.php
index bdb963fe..4f3357c2 100644
--- a/src/config/datatables.php
+++ b/src/config/datatables.php
@@ -33,6 +33,13 @@
* SQL: column LIKE "keyword%"
*/
'starts_with' => false,
+
+ /*
+ * Ignore accents when filtering/searching (accent-insensitive search).
+ * If true, accented characters will be normalized to their base letter.
+ * Example: 'Simões' will match 'simoes'.
+ */
+ 'ignore_accents' => false,
],
/*
diff --git a/tests/Unit/ConfigTest.php b/tests/Unit/ConfigTest.php
new file mode 100644
index 00000000..fc9efa25
--- /dev/null
+++ b/tests/Unit/ConfigTest.php
@@ -0,0 +1,60 @@
+config = app('datatables.config');
+ }
+
+ public function test_is_ignore_accents_default()
+ {
+ config(['datatables.search.ignore_accents' => false]);
+ $this->assertFalse($this->config->isIgnoreAccents());
+ }
+
+ public function test_is_ignore_accents_enabled()
+ {
+ config(['datatables.search.ignore_accents' => true]);
+ $this->assertTrue($this->config->isIgnoreAccents());
+ }
+
+ public function test_is_ignore_accents_with_null_config()
+ {
+ config(['datatables.search.ignore_accents' => null]);
+ $this->assertFalse($this->config->isIgnoreAccents());
+ }
+
+ public function test_is_ignore_accents_with_string_true()
+ {
+ config(['datatables.search.ignore_accents' => 'true']);
+ $this->assertTrue($this->config->isIgnoreAccents());
+ }
+
+ public function test_is_ignore_accents_with_string_false()
+ {
+ config(['datatables.search.ignore_accents' => 'false']);
+ $this->assertTrue($this->config->isIgnoreAccents()); // non-empty string is truthy
+ }
+
+ public function test_is_ignore_accents_with_zero()
+ {
+ config(['datatables.search.ignore_accents' => 0]);
+ $this->assertFalse($this->config->isIgnoreAccents());
+ }
+
+ public function test_is_ignore_accents_with_one()
+ {
+ config(['datatables.search.ignore_accents' => 1]);
+ $this->assertTrue($this->config->isIgnoreAccents());
+ }
+}
\ No newline at end of file
diff --git a/tests/Unit/HelperTest.php b/tests/Unit/HelperTest.php
index 65ac587c..8727439c 100644
--- a/tests/Unit/HelperTest.php
+++ b/tests/Unit/HelperTest.php
@@ -281,4 +281,40 @@ public function test_wildcard_string()
$this->assertEquals('.*k.*e.*y.*w.*o.*r.*d.*', $keyword);
}
+
+ public function test_normalize_accents()
+ {
+ // Test Portuguese Brazilian accents
+ $testCases = [
+ 'Tatiane Simões' => 'Tatiane Simoes',
+ 'João' => 'Joao',
+ 'São Paulo' => 'Sao Paulo',
+ 'José' => 'Jose',
+ 'Ação' => 'Acao',
+ 'Coração' => 'Coracao',
+ 'Não' => 'Nao',
+ 'Canção' => 'Cancao',
+ // Test all accent mappings individually
+ 'ãáàâ' => 'aaaa',
+ 'ÃÁÀÂ' => 'AAAA',
+ 'éê' => 'ee',
+ 'ÉÊ' => 'EE',
+ 'í' => 'i',
+ 'Í' => 'I',
+ 'óôõ' => 'ooo',
+ 'ÓÔÕ' => 'OOO',
+ 'ú' => 'u',
+ 'Ú' => 'U',
+ 'ç' => 'c',
+ 'Ç' => 'C',
+ // Test mixed content
+ 'Não há ação' => 'Nao ha acao',
+ 'Coração de São João' => 'Coracao de Sao Joao',
+ ];
+
+ foreach ($testCases as $input => $expected) {
+ $result = Helper::normalizeAccents($input);
+ $this->assertEquals($expected, $result, "Failed to normalize '$input'");
+ }
+ }
}