ICONS['SEARCH'], 'delete' => ICONS['DELETE']]; private array $_batchjobButtons = ['batchjob' => '일괄처리', 'batchjob_delete' => '일괄삭제']; protected function __construct() { $this->_validation = service('validation'); } public function action_init_process(string $action, array &$formDatas = []): void { $actionButtons = ['view' => ICONS['SEARCH'], 'delete' => ICONS['DELETE']]; $batchjobButtons = []; $this->setActionButtons($actionButtons); $this->setBatchjobButtons($batchjobButtons); } 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용 /** * 데이터를 검증하고 유효하지 않을 경우 예외를 발생시킵니다. * 2025 CI4 표준: 규칙 배열 내에 label을 포함하여 한글 메시지 출력을 보장합니다. * * @param array $formDatas 검증할 데이터 * @throws RuntimeException */ protected function sanitizeFormDatas($data, string $path = '') { if (!is_array($data)) return $data; foreach ($data as $k => $v) { if (is_array($v)) { $data[$k] = $this->sanitizeFormDatas($v, ($path !== '' ? "$path.$k" : (string) $k)); } elseif ($v === null) { $data[$k] = ''; } } return $data; } final public function validate(array &$formDatas): void { if ($this->_validation === null) { throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 오류발생: Validation 서비스가 초기화되지 않았습니다."); } try { //목적은 검증 전에 데이터 형태를 안전하게 정리 $formDatas = $this->sanitizeFormDatas($formDatas); // 1. 필드 라벨/규칙 $formFields = $this->getFormFields(); $formRules = $this->getFormRules(); if (empty($formRules)) { throw new RuntimeException(static::class . '->' . __FUNCTION__ . "에서 오류발생: 지정된 Form RULE이 없습니다."); } // ✅ 1.5 배열 원소 규칙(role.*)이 존재할 경우, 부모 필드(role)가 없으면 빈 배열로 보장 // 이렇게 해두면 엔진 내부에서 role.* 처리 중 trim(null) 류가 재발할 확률이 확 줄어듦 foreach ($formRules as $fieldKey => $ruleDef) { $fieldName = is_array($ruleDef) ? $fieldKey : $fieldKey; // role.* 형태면 부모 role을 배열로 보장 if (str_contains($fieldName, '.*')) { $parent = str_replace('.*', '', $fieldName); if (!array_key_exists($parent, $formDatas) || $formDatas[$parent] === '') { $formDatas[$parent] = []; } elseif (is_string($formDatas[$parent])) { // 혹시 문자열로 들어오면 CSV → 배열 복원 (공통 방어막) $formDatas[$parent] = ($formDatas[$parent] === '') ? [] : explode(DEFAULTS["DELIMITER_COMMA"], $formDatas[$parent]); } elseif (!is_array($formDatas[$parent])) { $formDatas[$parent] = []; } } } foreach ($formRules as $field => $rule) { try { // 2. 필드명/규칙 추출 list($field, $rule) = $this->getValidationRule($field, $rule); // 3. label 결정 if (isset($formFields[$field])) { $label = $formFields[$field]; } elseif (str_contains($field, '.*')) { $parentField = str_replace('.*', '', $field); $label = ($formFields[$parentField] ?? $field) . " 항목"; } else { $label = $field; } // 4. rules 설정 $dynamicRules = []; $dynamicRules[$field] = [ 'label' => $label, 'rules' => $rule ]; // ✅ 4.5 존재 보장 로직 수정 // - 일반 필드: 없으면 '' 세팅 // - 배열 원소 필드(role.*): 여기서 만들면 안 됨 (부모 role에서 처리해야 함) if (!array_key_exists($field, $formDatas) && !str_contains($field, '.*')) { $formDatas[$field] = ''; } } catch (\Throwable $e) { throw new RuntimeException("유효성 검사 규칙 준비 중 오류 발생 (필드: {$field}): " . $e->getMessage()); } } $this->_validation->setRules($dynamicRules); try { if (!$this->_validation->run($formDatas)) { $errors = $this->_validation->getErrors(); throw new RuntimeException(implode("\n", $errors)); } } catch (\TypeError $e) { // 너의 상세 디버깅 로직은 그대로 둬도 됨 (생략 가능) throw new RuntimeException("검증 도중 타입 오류 발생: " . $e->getMessage()); } } catch (\Throwable $e) { if ($e instanceof RuntimeException) throw $e; 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->getCustomTitle(); } $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; } }