Viewing file:  functions.php (4.02 KB) -rw-rw-rw-
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* Contains the Concord helper functions
*
* @copyright Copyright (c) 2016 Attila Fulop
* @author Attila Fulop
* @license MIT
* @since 2016-09-25
*
*/
use Illuminate\Database\Eloquent\Relations\Relation;
use Illuminate\Support\Arr;
use Illuminate\Support\Str;
use Konekt\Concord\Contracts\Concord;
/**
* Converts a fully qualified classname to a string (backslashes to dots, parts to snake case)
*
* Eg.: '\App\Services\BamBamService' -> 'app.services.bam_bam_service'
*
* @param string $classname
*
* @return string
*/
function classpath_to_slug($classname)
{
$parts = explode('\\', $classname);
// Remove first part if empty ie. begins with \
if (empty($parts[0])) {
$parts = Arr::except($parts, 0);
}
// Remove last part if empty ie. ends to \
if (empty($parts[count($parts) - 1])) {
$parts = Arr::except($parts, count($parts) - 1);
}
array_walk($parts, function (&$part) {
$part = Str::snake($part);
});
return implode('.', $parts);
}
/**
* Counterpart of classpath_to_slug, that converts the string back to a fully qualified classname
*
* Eg.: 'app.services.bam_bam_service' -> '\App\Services\BamBamService'
*
* @see classpath_to_slug()
*
* @param string $str
*
* @return string
*/
function slug_to_classpath($str)
{
$parts = explode('.', $str);
array_walk($parts, function (&$part) {
$part = Str::studly($part);
});
return implode('\\', $parts);
}
/**
* Returns a standard module name based on the module provider's classname
*
* Eg.: '\Vendor\Module\Providers\ModuleServiceProvider' -> 'vendor.module'
* 'App\Modules\Billing' -> 'billing'
*
* @param string $classname
* @param null|\Konekt\Concord\Contracts\Convention $convention
*
* @return string
*/
function concord_module_id($classname, $convention = null)
{
$convention = $convention ?: concord()->getConvention();
$modulesFolder = $convention->modulesFolder();
// Check if '\Modules\' is part of the namespace
$p = strrpos($classname, "\\$modulesFolder\\");
// if no \Modules\, but starts with 'Modules\' that's also a match
$p = false === $p ? strpos($classname, "$modulesFolder\\") : $p;
if (false !== $p) {
$parts = explode('\\', substr($classname, $p + strlen($modulesFolder) + 1));
$vendorAndModule = empty($parts[0]) ? Arr::only($parts, 1) : Arr::only($parts, 0);
} else {
$parts = explode('\\', $classname);
$vendorAndModule = empty($parts[0]) ? Arr::only($parts, [1,2]) : Arr::only($parts, [0,1]);
}
array_walk($vendorAndModule, function (&$part) {
$part = Str::snake($part);
});
return implode('.', $vendorAndModule);
}
/**
* Shortcut function for returning helper instances by their name
*
* @param string $name The name of the helper
* @param array $arguments Optional arguments to pass to the helper class
*
* @return object|null
*/
function helper($name, $arguments = [])
{
return concord()->helper($name, $arguments);
}
/**
* Returns the concord instance
*
* @return Concord
*/
function concord()
{
return app('concord');
}
/**
* Returns the classname shortened (no namespace, base class name only, snake_case
*
* @param string $classname
*
* @return string
*/
function shorten($classname)
{
return Str::snake(class_basename($classname));
}
/**
* Shorthand function for returning an enum object by it's short name
*
* @param string $shortname The short name of the enum
* @param mixed $value The value to create the enum with
*
* @return \Konekt\Enum\Enum
*/
function enum($shortname, $value = null)
{
$abstract = concord()->short($shortname);
if ($abstract && $class = concord()->enum($abstract)) {
return new $class($value);
}
}
function morph_type_of(string|object $model): string
{
$classname = is_string($model) ? $model : $model::class;
$alias = array_search($classname, Relation::morphMap());
return is_string($alias) ? $alias : $classname;
}
|