アクション名をチェックする
mixed
checkActionName
(string $action_name)
-
string
$action_name: アクション名
アプリケーションIDをチェックする
mixed
checkAppId
(string $id)
ビュー名をチェックする
mixed
checkViewName
(string $view_name)
(現在アクティブな)コントローラのインスタンスを返す
アプリケーションのエントリポイント
void
main
(string $class_name, [mixed $action_name = ""], [mixed $fallback_action_name = ""])
-
string
$class_name: アプリケーションコントローラのクラス名
-
mixed
$action_name: 指定のアクション名(省略可)
-
mixed
$fallback_action_name: アクションが決定できなかった場合に実行されるアクション名(省略可)
CLIアプリケーションのエントリポイント
void
main_CLI
(string $class_name, string $action_name, [bool $enable_filter = true])
-
string
$class_name: アプリケーションコントローラのクラス名
-
string
$action_name: 実行するアクション名
-
bool
$enable_filter: フィルタチェインを有効にするかどうか
SOAPアプリケーションのエントリポイント
void
main_SOAP
(string $class_name, [mixed $action_name = ""], [mixed $fallback_action_name = ""])
-
string
$class_name: アプリケーションコントローラのクラス名
-
mixed
$action_name: 指定のアクション名(省略可)
-
mixed
$fallback_action_name: アクションが決定できなかった場合に実行されるアクション名(省略可)
XMLRPCアプリケーションのエントリポイント
void
main_XMLRPC
( $class_name)
Ethna_Controllerクラスのコンストラクタ
Ethna_Controller
__construct
([ $gateway = GATEWAY_WWW])
getDefaultActionClass()で取得したクラス名からアクション名を取得する
getDefaultActionClass()をオーバーライドした場合、こちらも合わせてオーバーライド することを推奨(必須ではない)
string
actionClassToName
(string $class_name)
-
string
$class_name: アクションクラス名
getDefaultFormClass()で取得したクラス名からアクション名を取得する
getDefaultFormClass()をオーバーライドした場合、こちらも合わせてオーバーライド することを推奨(必須ではない)
string
actionFormToName
(string $class_name)
-
string
$class_name: フォームクラス名
アプリケーション実行後の後始末を行います。
void
end
()
Ethnaマネージャが実行不能な場合のエラーメッセージを 表示する。運用上の都合でこのメッセージを出力したくない 場合は、このメソッドをオーバーライドせよ
void
ethnaManagerCheckErrorMsg
( $action_name)
テンプレートパス名から遷移名を取得する
getDefaultForwardPath()をオーバーライドした場合、こちらも合わせてオーバーライド することを推奨(必須ではない)
string
forwardPathToName
(string $forward_path)
-
string
$forward_path: テンプレートパス名
指定されたアクションのクラス名を返す(オブジェクトの生成は行わない)
string
getActionClassName
(string $action_name)
-
string
$action_name: アクションの名称
アクションディレクトリ名を決定する
string
getActiondir
([ $gateway = null])
指定されたアクションのフォームクラス名を返す(オブジェクトの生成は行わない)
string
getActionFormName
(string $action_name)
-
string
$action_name: アクション名
アクション名を指定するクエリ/HTMLを生成する
void
getActionRequest
(string $action, [string $type = "hidden"])
-
string
$action: action to request
-
string
$type: hidden, url...
アプリケーションIDを返す
string
getAppId
()
アプリケーションベースディレクトリを返す
string
getBasedir
()
CLI実行中フラグを取得する
bool
getCLI
()
クライアントエンコーディング名へのアクセサ(R)
string
getClientEncoding
()
実行中のアクション名を返す
string
getCurrentActionName
()
DB設定を返す
string
getDBType
([string $db_key = null])
-
string
$db_key: DBキー("", "r", "rw", "default", "blog_r"...)
アクションに対応するアクションクラス名が省略された場合のデフォルトクラス名を返す
デフォルトでは[プロジェクトID]_Action_[アクション名]となるので好み応じてオーバライドする
string
getDefaultActionClass
(string $action_name, [ $gateway = null])
-
string
$action_name: アクション名
-
$gateway
アクションに対応するアクションパス名が省略された場合のデフォルトパス名を返す
デフォルトでは"foo_bar" -> "/Foo/Bar.php"となるので好み応じてオーバーライドする
string
getDefaultActionPath
(string $action_name)
-
string
$action_name: アクション名
アクションに対応するフォームクラス名が省略された場合のデフォルトクラス名を返す
デフォルトでは[プロジェクトID]_Form_[アクション名]となるので好み応じてオーバライドする
string
getDefaultFormClass
(string $action_name, [ $gateway = null])
-
string
$action_name: アクション名
-
$gateway
アクションに対応するフォームパス名が省略された場合のデフォルトパス名を返す
デフォルトでは_getDefaultActionPath()と同じ結果を返す(1ファイルに アクションクラスとフォームクラスが記述される)ので、好みに応じて オーバーライドする
string
getDefaultFormPath
(string $action_name)
-
string
$action_name: アクション名
遷移名に対応するテンプレートパス名が省略された場合のデフォルトパス名を返す
デフォルトでは"foo_bar"というforward名が"foo/bar" + テンプレート拡張子となる ので好み応じてオーバライドする
string
getDefaultForwardPath
(string $forward_name)
-
string
$forward_name: forward名
遷移名に対応するビュークラス名が省略された場合のデフォルトクラス名を返す
デフォルトでは[プロジェクトID]_View_[遷移名]となるので好み応じてオーバライドする
string
getDefaultViewClass
(string $forward_name, [ $gateway = null])
-
string
$forward_name: forward名
-
$gateway
遷移名に対応するビューパス名が省略された場合のデフォルトパス名を返す
デフォルトでは"foo_bar" -> "/Foo/Bar.php"となるので好み応じてオーバーライドする
string
getDefaultViewPath
(string $forward_name)
-
string
$forward_name: forward名
アプリケーションディレクトリ設定を返す
string
getDirectory
(string $key)
-
string
$key: ディレクトリタイプ("tmp", "template"...)
DSNを返す
string
getDSN
([string $db_key = ""])
DSNの持続接続設定を返す
bool
getDSN_persistent
([string $db_key = ""])
エラーメッセージを取得する
string
getErrorMessage
(int $code)
アプリケーション拡張子設定を返す
string
getExt
(string $key)
-
string
$key: 拡張子タイプ("php", "tpl"...)
ゲートウェイを取得する
void
getGateway
()
ロケール設定、使用言語を取得する
array
getLanguage
()
ロケール名へのアクセサ(R)
string
getLocale
()
マネージャクラス名を取得する
string
getManagerClassName
(string $name)
マネージャ一覧を返す
array
getManagerList
()
アプリケーションオブジェクトクラス名を取得する
string
getObjectClassName
(string $name)
-
string
$name: アプリケーションオブジェクトキー
クライアントタイプ/言語からテンプレートディレクトリ名を決定する デフォルトでは [appid]/template/ja_JP/ (ja_JPはロケール名) ロケール名は _getDefaultLanguage で決定される。
string
getTemplatedir
()
テンプレートエンジン取得する (DEPRECATED) getRenderer() を使ってください
(action,view以外の)テストケースを置くディレクトリ名を決定する
string
getTestdir
()
アプリケーションベースURLを返す
string
getURL
()
Accessor for ViewClass
object Ethna_View
getView
()
指定された遷移名に対応するビュークラス名を返す(オブジェクトの生成は行わない)
string
getViewClassName
(string $forward_name)
-
string
$forward_name: 遷移先の名称
ビューディレクトリ名を決定する
string
getViewdir
()
実行中のXMLRPCメソッド名を返す
string
getXmlrpcMethodName
()
エラーハンドラ
エラー発生時の追加処理を行いたい場合はこのメソッドをオーバーライドする (アラートメール送信等−デフォルトではログ出力時にアラートメール が送信されるが、エラー発生時に別にアラートメールをここで送信 させることも可能)
Setter for ActionForm if the ::$action_form class is not null, then cannot set the view
CLI実行中フラグを設定する
void
setCLI
(bool $cli)
クライアントエンコーディング名へのアクセサ(W)
void
setClientEncoding
(string $client_encoding)
-
string
$client_encoding: クライアントエンコーディング名
アプリケーションディレクトリ設定を返す
string
setDirectory
(string $key, $value)
ゲートウェイモードを設定する
void
setGateway
( $gateway)
ロケール名へのアクセサ(W)
void
setLocale
($locale $locale)
-
$locale
$locale: ロケール名(e.x ja_JP, en_US 等), (ロケール名は、ll_cc の形式。ll = 言語コード cc = 国コード)
Setter for ViewClass if the ::$view class is not null, then cannot set the view
boolean
setView
($view $view)
-
$view
$view: object Ethna_ViewClass
フレームワークの処理を開始する
mixed
trigger
([mixed $default_action_name = ""], [mixed $fallback_action_name = ""], [bool $enable_filter = true])
-
mixed
$default_action_name: 指定のアクション名
-
mixed
$fallback_action_name: アクション名が決定できなかった場合に実行されるアクション名
-
bool
$enable_filter: フィルタチェインを有効にするかどうか
Ethnaマネージャを設定する
不要な場合は空のメソッドとしてオーバーライドしてもよい
void
_activateEthnaManager
()
フィルタチェインを生成する
void
_createFilterChain
()
Ethnaマネージャが実行可能かをチェックする
Ethnaマネージャを実行するよう指示されているにも関わらず、 debug が trueでない場合は実行を停止する。
void
_ethnaManagerEnabledCheck
( $action_name)
フォームにより要求されたアクション名に対応する定義を返す
array
_getAction
(string $action_name, [ $gateway = null])
-
string
$action_name: アクション名
-
$gateway
フォームにより要求されたアクション名を返す
アプリケーションの性質に応じてこのメソッドをオーバーライドして下さい。 デフォルトでは"action_"で始まるフォーム値の"action_"の部分を除いたもの ("action_sample"なら"sample")がアクション名として扱われます
string
_getActionName_Form
()
デフォルト状態でのゲートウェイを取得する
int
_getDefaultGateway
( $gateway)
デフォルト状態での使用言語を取得する 外部に出力されるEthnaのエラーメッセージ等のエンコーディングを 切り替えたい場合は、このメソッドをオーバーライドする。
array
_getDefaultLanguage
()
遷移名からテンプレートファイルのパス名を取得する
string
_getForwardPath
(string $forward_name)
-
string
$forward_name: forward名
ゲートウェイに対応したクラス名のプレフィクスを取得する
string
_getGatewayPrefix
([string $gateway = null])
アクションスクリプトをインクルードする
ただし、インクルードしたファイルにクラスが正しく定義されているかどうかは保証しない
void
_includeActionScript
(array $action_obj, string $action_name)
-
array
$action_obj: アクション定義
-
string
$action_name: アクション名
ディレクトリ以下の全てのスクリプトをインクルードする
void
_includeDirectory
( $dir)
ビュースクリプトをインクルードする
ただし、インクルードしたファイルにクラスが正しく定義されているかどうかは保証しない
void
_includeViewScript
(array $forward_obj, string $forward_name)
-
array
$forward_obj: 遷移定義
-
string
$forward_name: 遷移名
設定ファイルのDSN定義から使用するデータを再構築する(スレーブアクセス分岐等)
DSNの定義方法(デフォルト:設定ファイル)を変えたい場合はここをオーバーライドする
array
_prepareDSN
()
DSNのアクセス分岐を行う
スレーブサーバへの振分け処理(デフォルト:ランダム)を変更したい場合はこのメソッドをオーバーライドする
string
_selectDSN
(string $type, array $dsn_list)
-
string
$type: DB種別
-
array
$dsn_list: DSN一覧
使用言語、ロケールを設定する 条件によって使用言語、ロケールを切り替えたい場合は、 このメソッドをオーバーライドする。
void
_setLanguage
(string $locale, [string $system_encoding = null], [string $client_encoding = null])
-
string
$locale: ロケール名(ja_JP, en_US等) (ll_cc の形式。ll = 言語コード cc = 国コード)
-
string
$system_encoding: システムエンコーディング名
-
string
$client_encoding: クライアントエンコーディング(テンプレートのエンコーディングと考えれば良い)
アクション名とアクションクラスからの戻り値に基づいて遷移先を決定する
string
_sortForward
(string $action_name, string $retval)
-
string
$action_name: アクション名
-
string
$retval: アクションクラスからの戻り値