PHP
Laravel
Sınıflar
Fonksiyonlar
Kimlik doğrulama
Kullanıcı yönetimi
Lisans: MIT
PHP (Laravel) — Helper Sınıfı (Helper.php)
Orijinal Kod Adı:
PHP (Laravel) — Helper.php
Bu PHP (Laravel) kodu (`Helper.php`), modüler iş mantığını ve yardımcı rutinleri uygular. Dosya ölçeği: 103 satır (~2.6 KB). Ad alanı (namespace): `Kodeine\Acl\Helper`. Tanımlı sınıf/yapılar: Helper. Sağladığı başlıca fonksiyonlar: `toDotPermissions`, `parseOperator` (ayrıştırma), `hasDelimiterToArray`, `mapArray`. Kullandığı modül/paketler: Illuminate\Support\Collection. Kaynak depo: kodeine/laravel-acl.
💡 Püf Noktaları:
• `Helper.php` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• PHP kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
• Üçüncü parti modüllerin bilinen zafiyet ve sürüm uyumluluğunu düzenli olarak denetleyip değişiklikleri sürüm geçmişinde izleyin.
🛠️ Uygulama Tarifi:
1. Dosyayı projenize dahil edin ve yükleyici üzerinden sınıfa erişin: `use Kodeine\Acl\Helper\Helper;`.
2. Yapılandırma/DSN parametrelerini hazırlayarak sınıf örneğini oluşturun: `$nesne = new Helper(...);`.
3. `try { $sonuc = $nesne->toDotPermissions(...); } catch (\Throwable $e) { ... }` bloğu içinde işlemi güvenle yürütün ve hata günlüğünü izleyin.
💡 Püf Noktaları:
• `Helper.php` dosyasındaki ortam bağımlı sabitleri (DSN, anahtar, URL) doğrudan kod yerine `.env` veya merkezi ayar katmanından okuyun.
• PHP kodunu canlı ortama taşımadan önce kenar durumları (boş girdi, zaman aşımı, hatalı format) için test senaryosu oluşturun.
• Üçüncü parti modüllerin bilinen zafiyet ve sürüm uyumluluğunu düzenli olarak denetleyip değişiklikleri sürüm geçmişinde izleyin.
🛠️ Uygulama Tarifi:
1. Dosyayı projenize dahil edin ve yükleyici üzerinden sınıfa erişin: `use Kodeine\Acl\Helper\Helper;`.
2. Yapılandırma/DSN parametrelerini hazırlayarak sınıf örneğini oluşturun: `$nesne = new Helper(...);`.
3. `try { $sonuc = $nesne->toDotPermissions(...); } catch (\Throwable $e) { ... }` bloğu içinde işlemi güvenle yürütün ve hata günlüğünü izleyin.
Dikkat Edilmesi Gerekenler:
• [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] Ü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.
<?php
namespace Kodeine\Acl\Helper;
use Illuminate\Support\Collection;
trait Helper
{
/*
|----------------------------------------------------------------------
| Slug Permission Related Protected Methods
|----------------------------------------------------------------------
|
*/
protected function toDotPermissions(array $permissions)
{
$data = [];
//$permissions = $this->permissions->lists('slug', 'name');
foreach ($permissions as $alias => $perm) {
if ( ! is_array($perm) ) continue;
foreach ($perm as $key => $value) {
//if ( (bool) $value == false ) continue;
$slug = $key . '.' . $alias;
$data[$slug] = $value;
//$data[] = $slug;
}
}
return $data;
}
/*
|----------------------------------------------------------------------
| Protected Methods
|----------------------------------------------------------------------
|
*/
protected function parseOperator($str)
{
// if its an array lets use
// and operator by default
if ( is_array($str) ) {
$str = implode(',', $str);
}
if ( preg_match('/([,|])(?:\s+)?/', $str, $m) ) {
return $m[1] == '|' ? 'or' : 'and';
}
return false;
}
/**
* Converts strings having comma
* or pipe to an array in
* lowercase
*
* @param $str
* @return array
*/
protected function hasDelimiterToArray($str)
{
if ( is_string($str) && preg_match('/[,|]/is', $str) ) {
return preg_split('/ ?[,|] ?/', strtolower($str));
}
return is_array($str) ?
array_filter($str, 'strtolower') :
(is_object($str) ? $str : strtolower($str));
}
/**
* @param $item
* @param callable $closure
* @return array
*/
protected function mapArray($item, \Closure $closure)
{
$item = $this->hasDelimiterToArray($item);
// item is a collection.
if ($item instanceof Collection) {
$item = $item->pluck('name')->all();
}
// multiple items
if ( is_array($item) ) {
// is an array of One Role/Permission
// its an array containing id
// we dont have to loop through
if ( isset($item['id']) )
return $closure((int) $item['id']);
// is an array of slugs
return array_map($closure, $item);
}
// single item
return $closure($item);
}
}