trafficmonitor/app/Helpers/CommonHelper.php
2025-11-11 14:51:31 +09:00

294 lines
11 KiB
PHP

<?php
namespace App\Helpers;
use App\Entities\CommonEntity;
use App\Traits\UtilTrait;
use RuntimeException;
class CommonHelper
{
use UtilTrait;
private array $_attributes = [];
protected function __construct() {}
final public function setAttributes(array $attributes): void
{
$this->_attributes = $attributes;
}
final public function getAttribute(string $key): string
{
if (!array_key_exists($key, $this->_attributes)) {
throw new RuntimeException(__METHOD__ . "에서 오류발생: {$key}에 해당하는 속성이 정의되지 않았습니다.");
}
return $this->_attributes[$key];
}
public function getFieldLabel(string $field, string $label, array $viewDatas, array $extras = []): string
{
switch ($field) {
default:
$extras = (strpos($viewDatas['formRules'][$field], 'required') !== false) ? ["class" => "text-danger", "required" => "", ...$extras] : $extras;
$label = form_label($label, $field, ['class' => 'form-label-sm', ...$extras]);
break;
}
return $label;
}
/**
* CI4의 form_dropdown()을 확장하여 <option> 태그에 data-* 속성을 추가할 수 있도록 합니다.
*
* @param string $name 폼 필드 이름
* @param array $options 드롭다운 옵션 배열.
* 값은 문자열/정수, 또는 추가 속성을 포함하는 배열일 수 있습니다.
* 예: ['value' => 'test1', 'text' => 'Test 1', 'data-price' => 1000]
* @param string|array|null $selected 현재 선택된 값
* @param string $extra <select> 태그에 추가할 속성
* @return string HTML <select> 태그
*/
public function form_dropdown_custom(string $name = '', array $options = [], $selected = null, string $extra = ''): string
{
$select = '<select name="' . esc($name) . '"' . $extra . ">\n";
// 선택된 값 처리
$selected = is_array($selected) ? $selected : [$selected];
foreach ($options as $key => $val) {
// 💡 핵심 로직: $val이 배열인지 확인합니다.
if (is_array($val)) {
// $val이 배열인 경우: 복합 옵션 (value, text, data-* 속성 포함)
$optionValue = $val['value'] ?? $key; // value가 없으면 키 사용
$optionText = $val['text'] ?? $optionValue;
$optionAttributes = '';
// data-* 속성 추출 및 조합
foreach ($val as $attrKey => $attrValue) {
// 'value'와 'text'는 <option> 속성이 아니므로 제외
if ($attrKey !== 'value' && $attrKey !== 'text') {
$optionAttributes .= " " . esc($attrKey) . '="' . esc($attrValue) . '"';
}
}
$optionSelected = in_array($optionValue, $selected) ? ' selected="selected"' : '';
$select .= '<option value="' . esc($optionValue) . '"' . $optionAttributes . $optionSelected . '>'
. esc($optionText)
. "</option>\n";
} else {
// $val이 배열이 아닌 경우: 일반 옵션 (기존 form_dropdown() 방식)
$optionSelected = in_array($key, $selected) ? ' selected="selected"' : '';
$select .= '<option value="' . esc($key) . '"' . $optionSelected . '>'
. esc($val)
. "</option>\n";
}
}
$select .= "</select>\n";
return $select;
}
public function getFieldForm(string $field, mixed $value, array $viewDatas, array $extras = []): string
{
switch ($field) {
case 'email':
$extras['class'] = array_key_exists('class', $extras) ? $extras['class'] . ' form-control' : 'form-control';
$extras['style'] = 'width:100%;';
$extras['placeholder'] = '예)test@example.co.kr';
$form = form_input($field, $value ?? "", $extras);
break;
case 'mobile':
case 'phone':
$extras['class'] = array_key_exists('class', $extras) ? $extras['class'] . ' form-control' : 'form-control';
$extras['style'] = 'width:100%;';
$extras['placeholder'] = '예)010-0010-0010';
$form = form_input($field, $value ?? "", $extras);
break;
case 'issue_at':
case 'expired_at':
case 'billing_at':
case 'start_at':
case 'end_at':
case 'updated_at':
case 'created_at':
case 'deleted_at':
$extras['class'] = array_key_exists('class', $extras) ? $extras['class'] . ' form-control calender' : 'form-control calender';
$extras['style'] = 'width:100%;';
$form = form_input($field, $value ?? "", $extras);
break;
case 'description':
case 'content':
case 'detail':
case 'history':
$extras['class'] = array_key_exists('class', $extras) ? $extras['class'] . ' form-control tinymce' : 'form-control tinymce';
$extras['style'] = 'width:100%;';
$form = form_textarea($field, html_entity_decode($value ?? "", ENT_QUOTES, 'UTF-8'), $extras);
break;
default:
$extras['class'] = array_key_exists('class', $extras) ? $extras['class'] . ' form-control' : 'form-control';
if (in_array($field, $viewDatas['formFilters'])) {
$form = form_dropdown($field, $viewDatas['formOptions'][$field]['options'], $value, [...$extras, ...$viewDatas['formOptions'][$field]['extras']]);
} else {
$extras['style'] = 'width:100%;';
$form = form_input($field, $value ?? "", $extras);
}
break;
}
return $form;
}
public function getFieldView(string $field, mixed $value, array $viewDatas, array $extras = []): string|null
{
switch ($field) {
case 'clientinfo_uid':
if (array_key_exists($value, $viewDatas['formOptions'][$field]['options'])) {
$value = "<a href=\"/admin/customer/client/detail/{$value}\">{$viewDatas['formOptions'][$field]['options'][$value]}</a>";
}
break;
case 'role':
$roles = [];
foreach ($value as $key) {
$roles[] = $viewDatas['formOptions'][$field]['options'][$key] ?? "";
}
$value = implode(" , ", $roles);
break;
case 'description':
case 'content':
case 'detail':
case 'history':
if (in_array($viewDatas['action'], ['view', 'index'])) {
$value = html_entity_decode($value, ENT_QUOTES, 'UTF-8');
}
break;
case 'issue_at':
case 'expired_at':
case 'billing_at':
case 'start_at':
case 'end_at':
case 'updated_at':
case 'created_at':
case 'deleted_at':
$value = $value ? date("Y-m-d", strtotime($value)) : "";
break;
default:
if (in_array($field, $viewDatas['formFilters'])) {
$value = $viewDatas['formOptions'][$field]['options'][$value] ?? "";
}
break;
}
if (is_array($value)) {
throw new \Exception(__METHOD__ . "에서 오류: {$field}의 값이 Array형태입니다");
}
return $value;
}
public function getListFilter(string $field, mixed $value, array $viewDatas, $extras = []): string
{
switch ($field) {
default:
$filter = "";
if (in_array($field, $viewDatas['formFilters'])) {
$filter = form_dropdown(
$field,
$viewDatas['formOptions'][$field]['options'],
$value,
[...$extras, ...$viewDatas['formOptions'][$field]['extras']]
);
}
break;
}
return $filter;
}
public function getListLabel(string $field, string $label, array $viewDatas, array $extras = []): string
{
switch ($field) {
default:
if (isset($viewDatas['order_field']) && $viewDatas['order_field'] == $field) {
$label .= $viewDatas['order_value'] == 'ASC' ? ICONS["UP"] : ICONS["DOWN"];
}
$query = $viewDatas['uri']->getQuery(['except' => ['order_field', 'order_value']]);
$query .= empty($query) ? "" : "&";
$query .= "order_field={$field}&order_value=";
$query .= isset($viewDatas['order_value']) && $viewDatas['order_value'] == 'DESC' ? "ASC" : "DESC";
$label = anchor(current_url() . "?" . $query, $label);
form_dropdown('perpage', $viewDatas['index_pagination_options'], $viewDatas['perpage'], ['onChange' => 'this.form.submit()']);
break;
}
return $label;
}
public function getListButton(string $action, string $label, array $viewDatas, array $extras = []): string
{
switch ($action) {
case 'create':
$action = form_label(
$label ? $label : '입력',
$action,
[
"data-src" => current_url() . '/' . $action . '?' . $viewDatas['uri']->getQuery(),
"data-bs-toggle" => "modal",
"data-bs-target" => "#modal_action_form",
"class" => "btn btn-sm btn-primary form-label-sm",
...$extras
]
);
break;
case 'modify':
$oldBatchJobUids = old("batchjob_uids", null);
$oldBatchJobUids = is_array($oldBatchJobUids) ? $oldBatchJobUids : [$oldBatchJobUids];
$checkbox = form_checkbox([
"id" => "checkbox_uid_{$viewDatas['entity']->getPK()}",
"name" => "batchjob_uids[]",
"value" => $viewDatas['entity']->getPK(),
"class" => "batchjobuids_checkboxs",
"checked" => in_array($viewDatas['entity']->getPK(), $oldBatchJobUids)
]);
$action = $checkbox . form_label(
$label ? $label : '수정',
$action,
[
"data-src" => current_url() . '/' . $action . '/' . $viewDatas['entity']->getPK() . '?' . $viewDatas['uri']->getQuery(),
"data-bs-toggle" => "modal",
"data-bs-target" => "#modal_action_form",
'class' => 'form-label-sm',
...$extras
]
);
break;
case 'view':
$action = form_label(
$label ? $label : ICONS['SEARCH'],
$action,
[
"data-src" => current_url() . '/' . $action . '/' . $viewDatas['entity']->getPK() . '?' . $viewDatas['uri']->getQuery(),
"data-bs-toggle" => "modal",
"data-bs-target" => "#modal_action_form",
"class" => "btn btn-sm btn-primary form-label-sm",
...$extras
]
);
break;
case 'delete':
$action = anchor(
current_url() . '/' . $action . '/' . $viewDatas['entity']->getPK(),
$label ? $label : ICONS['DELETE'],
[
"class" => "btn btn-sm btn-danger form-label-sm",
...$extras
]
);
break;
case 'batchjob':
$action = form_submit("batchjob_submit", $label ? $label : '일괄처리', [
"formaction" => current_url() . '/batchjob',
"class" => "btn btn-sm btn-warning form-label-sm",
...$extras,
// "onclick" => "return submitBatchJob()"
]);
break;
case 'batchjob_delete':
$action = form_submit("batchjob_submit", $label ? $label : '일괄삭제', [
"formaction" => current_url() . '/batchjob_delete',
"class" => "btn btn-sm btn-danger form-label-sm",
...$extras,
// "onclick" => "return submitBatchJobDelete()"
]);
break;
default:
$action = "";
break;
}
return $action;
}
}