dbmsv4/app/Forms/CommonForm.php
2025-12-18 18:34:22 +09:00

266 lines
9.9 KiB
PHP

<?php
namespace App\Forms;
use RuntimeException;
abstract class CommonForm
{
private $_validation = null;
private array $_attributes = [];
private array $_formFields = [];
private array $_formRules = [];
private array $_formFilters = [];
private array $_indexFilters = [];
private array $_batchjobFilters = [];
private array $_formOptions = [];
private array $_actionButtons = ['view' => ICONS['SEARCH'], 'delete' => ICONS['DELETE']];
private array $_batchjobButtons = ['batchjob' => '일괄처리', 'batchjob_delete' => '일괄삭제'];
protected function __construct()
{
$this->_validation = service('validation');
}
abstract public function action_init_process(string $action, array $formDatas = []): void;
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(static::class . '->' . __FUNCTION__ . "에서 오류발생: {$key}에 해당하는 속성이 정의되지 않았습니다.");
}
return $this->_attributes[$key];
}
final public function setFormFields(array $fields): void
{
foreach ($fields as $field) {
$this->_formFields[$field] = $this->getFormFieldLabel($field);
}
}
//$fields 매치된것만 반환, []->전체
final public function getFormFields(array $fields = []): array
{
if (empty($fields)) {
return $this->_formFields;
}
// _formFields와 키를 비교하여 교집합을 반환합니다. $fields에 지정된 필드 정의만 추출됩니다.
return array_intersect_key($this->_formFields, array_flip($fields));
}
public function setFormRules(string $action, array $fields, $formRules = []): void
{
foreach ($fields as $field) {
$formRules = $this->getFormRule($action, $field, $formRules);
}
$this->_formRules = $formRules;
}
final public function getFormRules(array $fields = []): array
{
if (empty($fields)) {
return $this->_formRules;
}
return array_intersect_key($this->_formRules, array_flip($fields));
}
final public function setFormOptions(string $action, array $fields, array $formDatas = [], $formOptions = []): void
{
foreach ($fields as $field) {
$formOptions[$field] = $formOptions[$field] ?? $this->getFormOption($action, $field, $formDatas);
}
$this->_formOptions = $formOptions;
}
//$fields 매치된것만 반환, []->전체
final public function getFormOptions(array $fields = []): array
{
if (empty($fields)) {
return $this->_formOptions;
}
return array_intersect_key($this->_formOptions, array_flip($fields));
}
final public function setFormFilters(array $fields): void
{
$this->_formFilters = $fields;
}
final public function getFormFilters(): array
{
return $this->_formFilters;
}
final public function setIndexFilters(array $fields): void
{
$this->_indexFilters = $fields;;
}
final public function getIndexFilters(): array
{
return $this->_indexFilters;
}
final public function setBatchjobFilters(array $fields): void
{
$this->_batchjobFilters = $fields;;
}
final public function getBatchjobFilters(): array
{
return $this->_batchjobFilters;
}
final public function setActionButtons(array $buttons): array
{
return $this->_actionButtons = $buttons;
}
final public function getActionButtons(): array
{
return $this->_actionButtons;
}
final public function setBatchjobButtons(array $buttons): array
{
return $this->_batchjobButtons = $buttons;
}
final public function getBatchjobButtons(): array
{
return $this->_batchjobButtons;
}
//Validation용
final public function validate(array $formDatas): void
{
if ($this->_validation === null) {
throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 오류발생: Validation 서비스가 초기화되지 않았습니다.");
}
$dynamicRules = [];
$dynamicLabels = []; // 레이블 배열 추가
try {
foreach ($this->getFormRules() as $field => $rule) {
list($field, $rule) = $this->getValidationRule($field, $rule);
$dynamicRules[$field] = $rule; // 규칙만 저장
// role.* 키가 getFormFields()에 없을 확률이 99%이므로 isset 체크를 합니다.
$formFields = $this->getFormFields();
if (isset($formFields[$field])) {
$dynamicLabels[$field] = $formFields[$field];
} elseif (str_contains($field, '.*')) {
// role.* 형태라면 부모인 'role'의 레이블을 가져오거나 직접 명시
$parentField = str_replace('.*', '', $field);
$dynamicLabels[$field] = ($formFields[$parentField] ?? $field) . " 항목";
} else {
$dynamicLabels[$field] = $field; // 기본값
}
}
if (!count($dynamicRules)) {
throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 오류발생: 지정된 Form RULE이 없습니다.");
}
// setRules의 세 번째 인자로 레이블 전달
$this->_validation->setRules($dynamicRules, [], $dynamicLabels);
if (!$this->_validation->run($formDatas)) {
throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 데이터 검증 오류발생: " . var_export($this->_validation->getErrors(), true));
}
} catch (\Throwable $e) {
log_message('debug', 'Validate Rules: ' . var_export($this->getFormRules(), true));
log_message('debug', 'Validate Dynamic Rules: ' . var_export($dynamicRules, true));
log_message('debug', 'Validate Data: ' . var_export($formDatas, true));
throw new RuntimeException($e->getMessage());
}
}
//필수함수
//사용자정의 함수
protected function getValidationRule(string $field, string $rule): array
{
return array($field, $rule);
}
public function getFormFieldLabel(string $field, ?string $label = null): string
{
switch ($field) {
default:
$label = $label ?? lang("{$this->getAttribute('class_path')}.label.{$field}");
break;
}
return $label;
}
public function getFormRule(string $action, string $field, array $formRules): array
{
switch ($field) {
case $this->getAttribute('pk_field'):
if (!$this->getAttribute('useAutoIncrement')) {
$formRules[$field] = sprintf("required|regex_match[/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/]%s", in_array($action, ["create"]) ? "|is_unique[{$this->getAttribute('table')}.{$field}]" : "");
} else {
$formRules[$field] = "required|numeric";
}
break;
case $this->getAttribute('title_field'):
$formRules[$field] = sprintf("required|trim|string%s", in_array($action, ["create", "create_form"]) ? "|is_unique[{$this->getAttribute('table')}.{$field}]" : "");
break;
case "code":
// a-zA-Z → 영문 대소문자,0-9 → 숫자,가-힣 → 한글 완성형,\- → 하이픈
$formRules[$field] = sprintf("required|regex_match[/^[a-zA-Z0-9가-힣\-\_]+$/]|min_length[4]%s", in_array($action, ["create"]) ? "|is_unique[{$this->getAttribute('table')}.{$field}]" : "");
break;
case "user_uid":
$formRules[$field] = "required|numeric";
break;
case "clientinfo_uid":
case "serviceinfo_uid":
case "serverinfo_uid":
$formRules[$field] = "permit_empty|numeric";
break;
case 'picture':
$formRules[$field] = "is_image[{$field}]|mime_in[{$field},image/jpg,image/jpeg,image/gif,image/png,image/webp]|max_size[{$field},300]|max_dims[{$field},2048,768]";
break;
case "updated_at":
case "created_at":
case "deleted_at":
$formRules[$field] = "permit_empty|trim|valid_date";
break;
default:
$formRules[$field] = "permit_empty|trim|string";
break;
}
return $formRules;
}
protected function getFormOption_process($service, string $action, string $field, array $formDatas = []): array
{
$entities = [];
switch ($field) {
default:
if (in_array($action, ['create_form', 'modify_form', 'alternative_create_form'])) {
if (array_key_exists($field, $formDatas)) {
$where = sprintf("status = '%s' OR %s='%s'", STATUS['AVAILABLE'], $this->getAttribute('pk_field'), $formDatas[$field]);
} else {
$where = sprintf("status = '%s'", STATUS['AVAILABLE']);
}
$entities = $service->getEntities([$where => null]);
} else {
$entities = $service->getEntities();
}
break;
}
return $entities;
}
public function getFormOption(string $action, string $field, array $formDatas = [], array $options = ['options' => [], 'atttributes' => []]): array
{
$tempOptions = ['' => lang("{$this->getAttribute('class_path')}.label.{$field}") . " 선택"];
switch ($field) {
case 'user_uid':
foreach ($this->getFormOption_process(service('userservice'), $action, $field, $formDatas) as $entity) {
$tempOptions[$entity->getPK()] = $entity->getTitle();
}
$options['options'] = $tempOptions;
break;
case 'clientinfo_uid':
foreach ($this->getFormOption_process(service('customer_clientservice'), $action, $field, $formDatas) as $entity) {
$tempOptions[$entity->getPK()] = $entity->getTitle();
}
$options['options'] = $tempOptions;
break;
default:
$optionDatas = lang($this->getAttribute('class_path') . "." . strtoupper($field));
if (!is_array($optionDatas)) {
throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 오류발생:{$field}가 배열값이 아닙니다.");
}
foreach ($optionDatas as $key => $label) {
$tempOptions[$key] = $label;
}
$options['options'] = $tempOptions;
break;
}
return $options;
}
}