CreateLanguage
in package
Use case for creating a new language.
Tags
Table of Contents
Methods
- createFromData() : int
- Create a new language from data array (API-friendly version).
- execute() : array{success: bool, id: int}
- Create a new language from request data.
- getLanguageDataFromRequest() : array<string, string|int|bool|null>
- Get language data from request using InputValidator.
- buildLanguageSql() : void
- Build SQL and execute insert or update for a language.
- emptyToNull() : string|null
- Convert empty strings to null.
- getString() : string
- Get a string value from data array, defaulting to empty string.
- getStringOrNull() : string|null
- Get a string or null value from data array.
- normalizeLanguageData() : array<string, bool|int|null|string>
- Normalize language data from API request to database fields.
Methods
createFromData()
Create a new language from data array (API-friendly version).
public
createFromData(array<string, mixed> $data) : int
Parameters
- $data : array<string, mixed>
-
Language data (camelCase keys)
Return values
int —Created language ID, or 0 on failure
execute()
Create a new language from request data.
public
execute() : array{success: bool, id: int}
Return values
array{success: bool, id: int}getLanguageDataFromRequest()
Get language data from request using InputValidator.
public
getLanguageDataFromRequest() : array<string, string|int|bool|null>
Return values
array<string, string|int|bool|null>buildLanguageSql()
Build SQL and execute insert or update for a language.
private
buildLanguageSql(array<string, string|int|bool|null> $data[, int|null $id = null ]) : void
Parameters
- $data : array<string, string|int|bool|null>
-
Language data
- $id : int|null = null
-
Language ID for update, null for insert
emptyToNull()
Convert empty strings to null.
private
emptyToNull(string|null $value) : string|null
Parameters
- $value : string|null
-
Value to convert
Return values
string|null —Trimmed value or null if empty
getString()
Get a string value from data array, defaulting to empty string.
private
getString(array<string, string|int|bool|null> $data, string $key) : string
Parameters
- $data : array<string, string|int|bool|null>
-
Data array
- $key : string
-
Key to retrieve
Return values
string —Value as string
getStringOrNull()
Get a string or null value from data array.
private
getStringOrNull(array<string, string|int|bool|null> $data, string $key) : string|null
Parameters
- $data : array<string, string|int|bool|null>
-
Data array
- $key : string
-
Key to retrieve
Return values
string|null —Value as string or null
normalizeLanguageData()
Normalize language data from API request to database fields.
private
normalizeLanguageData(array<string, mixed> $data) : array<string, bool|int|null|string>
Parameters
- $data : array<string, mixed>
-
API request data (camelCase keys)
Return values
array<string, bool|int|null|string> —Normalized data (LgXxx keys)