Midari Create > webアプリケーション製品 > Wakarana > 関数マニュアル >

class wakarana_config

wakarana_commonの派生クラス。Wakaranaが組み込まれたアプリケーション本体のセットアップや設定変更の際に使用する。

wakarana_config::__construct($base_dir=NULL)

ベースフォルダに各種設定ファイル(wakarana_config.ini、wakarana_custom_fields.json、wakarana_email_domain_blacklist.conf)がなければ作成し、wakarana_common::__constructを実行する。

$base_dir : wakarana_config.iniのある(または作成する)フォルダのパス。省略時はcommon.phpのあるフォルダを使用する。

◆ wakarana_config::save()

現在の設定値でwakarana_config.iniを上書きする。
◆クラス内呼び出し専用。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::set_config_value($key, $value, $save_now=TRUE)

wakarana_config.iniの設定値を変更する。

$key : wakarana_config.iniの変数名
$value : 設定する値
$save_now : FALSEならwakarana_config.iniへの上書きは保留する。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::reset_config()

wakarana_config.iniの設定値を全て既定値に戻す。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

◆ wakarana_config::save_custom_fields()

現在の設定値でwakarana_custom_fields.jsonを上書きする。
◆クラス内呼び出し専用。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::add_custom_field($custom_field_name, $maximum_length=500, $records_per_user=1, $allow_nonunique_value=TRUE, $save_now=TRUE)

文字列型カスタムフィールドを追加する。
既に存在するカスタムフィールド名を指定した場合はその設定を上書きする。

$custom_field_name : カスタムフィールド名。半角英数字及びアンダーバーが使用可能。
$maximum_length : 保存可能な最大文字数(500以下)
$records_per_user : ユーザーあたりの上限件数(100以下)
$allow_nonunique_value : 異なるユーザーが同一の値を持つことを認めるか
$save_now : FALSEならwakarana_custom_fields.jsonへの上書きは保留する

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::add_custom_numerical_field($custom_field_name, $records_per_user=1, $allow_nonunique_value=TRUE, $save_now=TRUE)

数値型カスタムフィールドを追加する。
既に存在するカスタムフィールド名を指定した場合はその設定を上書きする。

$custom_field_name : カスタムフィールド名。半角英数字及びアンダーバーが使用可能。
$records_per_user : ユーザーあたりの上限件数(100以下)
$allow_nonunique_value : 異なるユーザーが同一の値を持つことを認めるか
$save_now : FALSEならwakarana_custom_fields.jsonへの上書きは保留する

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::delete_custom_field($custom_field_name, $save_now=TRUE)

カスタムフィールドを削除する。
この関数により既にデータベースに保存されている当該カスタムフィールドのデータが削除されるわけではない。

$custom_field_name : カスタムフィールド名
$save_now : FALSEならwakarana_custom_fields.jsonへの上書きは保留する。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

◆ wakarana_config::save_email_domain_blacklist()

メールドメインブラックリストを上書き保存する。
◆クラス内呼び出し専用。

wakarana_config::add_email_domain_to_blacklist($damain_name, $save_now=TRUE)

ドメインをメールドメインブラックリストに追加する。

$domain_name : ブラックリストに追加するドメイン名
$save_now : FALSEならwakarana_email_domain_blacklist.confへの上書きは保留する。

返り値 : 成功した場合はTRUE、既にブラックリストに登録されているドメインだった場合はNULLを返し、メールドメインに使用できない文字列だった場合や失敗した場合はFALSEを返す。

wakarana_config::remove_email_domain_from_blacklist($damain_name)

ドメインをメールドメインブラックリストから除外する。

$domain_name : ブラックリストから除外するドメイン名

返り値 : 成功した場合はTRUE、もとからブラックリストに登録されていないドメインだった場合や失敗した場合はFALSEを返す。

wakarana_config::merge_email_domain_blacklists($damain_names)

複数のドメインをまとめてメールドメインブラックリストに追加する。
既にブラックリストに登録されているドメインや、ドメイン名として無効な文字列が含まれていた場合、それらは無視される。

$domain_names : ドメイン名が1行に1つずつ記載された文字列

返り値 : 成功した場合はブラックリストに追加されたドメインの数を返し、失敗した場合はFALSEを返す。

wakarana_config::clear_email_domain_blacklist($save_now=TRUE)

メールドメインブラックリストの内容を全て削除する。

$save_now : FALSEならwakarana_email_domain_blacklist.confへの上書きは保留する。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。

wakarana_config::replace_email_domain_blacklist($damain_names)

既存のメールドメインブラックリストを削除し、新しいブラックリストで置き換える。
新しいブラックリストの記載内容のうち、ドメイン名として無効な文字列は自動的に除外される。

$domain_names : ドメイン名が1行に1つずつ記載された文字列

返り値 : 成功した場合は新しいブラックリストに登録されたドメインの数を返し、失敗した場合はFALSEを返す。

wakarana_config::setup_db()

データベースにテーブルを作成する。
SQLiteを使用する設定の場合、データベースファイルの作成も行われる。
作成されたテーブルには初期情報(ベースロールと特権管理者ロールの基本情報)が格納される。

返り値 : 成功した場合はTRUE、失敗した場合はFALSEを返す。