SQL
MariaDB
SQL sorguları
Kullanıcı yönetimi
API örnekleri
Lisans: MIT
SQL — MariaDB Veritabanı İşlemleri (MySQL.sql)
Orijinal Kod Adı:
SQL — MySQL.sql
Bu SQL ve MariaDB veritabanı kodu (`MySQL.sql`), veritabanı tabloları üzerinde sorgulama, filtreleme ve veri okuma/yazma akışını yürütür. Dosya ölçeği: 82 satır (~2.6 KB). Kaynak depo: JosephSilber/bouncer.
💡 Püf Noktaları:
• Tüm dinamik sorgularda `prepare()` + `execute()` parametre bağlama kullanarak SQL Injection riskini kökünden önleyin.
• Birden çok tabloyu etkileyen yazma işlemlerini `beginTransaction()` / `commit()` / `rollBack()` bloğu içinde atomik yürütün.
• `MySQL.sql` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• SQL kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Çalıştırmadan önce hedef veritabanının tam yedeğini alın ve sorguyu ilk olarak test/staging veritabanında doğrulayın.
2. Performans ve indeks kullanımını görmek için ana sorguların başına `EXPLAIN` ekleyerek tarama maliyetini inceleyin.
3. Değişiklikleri `BEGIN; ... COMMIT;` (hata halinde `ROLLBACK;`) transaction bloğu içinde uygulayın.
💡 Püf Noktaları:
• Tüm dinamik sorgularda `prepare()` + `execute()` parametre bağlama kullanarak SQL Injection riskini kökünden önleyin.
• Birden çok tabloyu etkileyen yazma işlemlerini `beginTransaction()` / `commit()` / `rollBack()` bloğu içinde atomik yürütün.
• `MySQL.sql` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• SQL kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
🛠️ Uygulama Tarifi:
1. Çalıştırmadan önce hedef veritabanının tam yedeğini alın ve sorguyu ilk olarak test/staging veritabanında doğrulayın.
2. Performans ve indeks kullanımını görmek için ana sorguların başına `EXPLAIN` ekleyerek tarama maliyetini inceleyin.
3. Değişiklikleri `BEGIN; ... COMMIT;` (hata halinde `ROLLBACK;`) transaction bloğu içinde uygulayın.
Dikkat Edilmesi Gerekenler:
• [Hata Yönetimi] Veritabanı veya dosya I/O akışında görünür `try/catch` (istisna) bloğu saptanmadı; kritik adımlarda istisna yakalama ve anlamlı loglama ekleyin.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
• [Hata Yönetimi] Veritabanı veya dosya I/O akışında görünür `try/catch` (istisna) bloğu saptanmadı; kritik adımlarda istisna yakalama ve anlamlı loglama ekleyin.
• [Hata Yönetimi] Üretime almadan önce geçersiz girdi, eksik ortam değişkeni ve bağlantı kesilmesi senaryoları için istisna/hata loglamasını doğrulayın.
• [Sürüm & Test] Bağımlılık ve çalışma ortamı sürümlerini (PHP/Node/Python/DB) hedef sunucuyla eşleştirip test ortamında doğruladıktan sonra dağıtın.
create table `abilities` (
`id` int unsigned not null auto_increment primary key,
`name` varchar(255) not null,
`title` varchar(255) null,
`entity_id` int unsigned null,
`entity_type` varchar(255) null,
`only_owned` tinyint(1) not null default '0',
`options` json null,
`scope` int null,
`created_at` timestamp null,
`updated_at` timestamp null
) default character set utf8mb4 collate utf8mb4_unicode_ci;
alter table `abilities`
add index `abilities_scope_index`(`scope`);
create table `roles` (
`id` int unsigned not null auto_increment primary key,
`name` varchar(255) not null,
`title` varchar(255) null,
`level` int unsigned null,
`scope` int null,
`created_at` timestamp null,
`updated_at` timestamp null
) default character set utf8mb4 collate utf8mb4_unicode_ci;
alter table `roles`
add unique `roles_name_unique`(`name`, `scope`);
alter table `roles`
add index `roles_scope_index`(`scope`);
create table `assigned_roles` (
`id` int unsigned not null auto_increment primary key,
`role_id` int unsigned not null,
`entity_id` int unsigned not null,
`entity_type` varchar(255) not null,
`restricted_to_id` int unsigned null,
`restricted_to_type` varchar(255) null,
`scope` int null
) default character set utf8mb4 collate utf8mb4_unicode_ci;
alter table `assigned_roles`
add index `assigned_roles_entity_index`(`entity_id`, `entity_type`, `scope`);
alter table `assigned_roles`
add constraint `assigned_roles_role_id_foreign`
foreign key (`role_id`)
references `roles` (`id`)
on delete cascade
on update cascade;
alter table `assigned_roles`
add index `assigned_roles_role_id_index`(`role_id`);
alter table `assigned_roles`
add index `assigned_roles_scope_index`(`scope`);
create table `permissions` (
`id` int unsigned not null auto_increment primary key,
`ability_id` int unsigned not null,
`entity_id` int unsigned null,
`entity_type` varchar(255) null,
`forbidden` tinyint(1) not null default '0',
`scope` int null
) default character set utf8mb4 collate utf8mb4_unicode_ci;
alter table `permissions`
add index `permissions_entity_index`(`entity_id`, `entity_type`, `scope`);
alter table `permissions`
add constraint `permissions_ability_id_foreign`
foreign key (`ability_id`)
references `abilities` (`id`)
on delete cascade
on update cascade;
alter table `permissions`
add index `permissions_ability_id_index`(`ability_id`);
alter table `permissions`
add index `permissions_scope_index`(`scope`);