Changeset 15078 for branches/feature-module-update/data/lib/glib.php

Timestamp:

2007/07/20 15:58:59 (17 years ago)

Author:

nanasess

Message:

r15064 から svn cp
とりあえず暫定コミット.

• UTF-8 に変更
• slib.php, glib.php のクラス化
• LC_Page の抽象化（一部）

Location:

branches/feature-module-update

Files:

• . (copied) (copied from branches/rel) (1 prop)
• data (copied) (copied from branches/rel/data)
• data/lib/glib.php (modified) (14 diffs)

branches/feature-module-update/data/lib/glib.php

@@ -7 +7 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfDownloadCsv
- * [³µÍ×] °ú¿ô¥Ç¡¼¥¿¤òCSV¤È¤·¤Æ¡¢¥¯¥é¥¤¥¢¥ó¥È¤Ë¥À¥¦¥ó¥í¡¼¥É¤µ¤»¤ë
- * [°ú¿ô] 1:¥Ø¥Ã¥Àʸ»úÎó 2:CSV¥Ç¡¼¥¿
- * [ÌáÃÍ] -
- * [°Í¸] -
- * [Ãí¼á] °ú¿ô¤Ï£±¡¤£²¤È¤â¥«¥ó¥Þ¶èÀÚ¤ê¤Ë¤Ê¤Ã¤Æ¤¤¤ë¤³¤È
+ * [名称] gfDownloadCsv
+ * [概要] 引数データをCSVとして、クライアントにダウンロードさせる
+ * [引数] 1:ヘッダ文字列 2:CSVデータ
+ * [戻値] -
+ * [依存] -
+ * [注釈] 引数は１，２ともカンマ区切りになっていること
  *----------------------------------------------------------------------*/
 function gfDownloadCsv($header, $contents){
@@ -18 +18 @@
     $fiest_name = date("YmdHis") .".csv";
     
-    /* HTTP¥Ø¥Ã¥À¤Î½ÐÎÏ */
+    /* HTTPヘッダの出力 */
     Header("Content-disposition: attachment; filename=${fiest_name}");
     Header("Content-type: application/octet-stream; name=${fiest_name}");
     
     $return = $header.$contents;
-    if (mb_detect_encoding($return) == CHAR_CODE){                      //ʸ»ú¥³¡¼¥ÉÊÑ´¹
+    if (mb_detect_encoding($return) == CHAR_CODE){                      //文字コード変換
         $return = mb_convert_encoding($return,'SJIS',CHAR_CODE);
-        $return = str_replace( array( "\r\n", "\r" ), "\n", $return);   // ²þ¹ÔÊýË¡¤ÎÅý°ì
+        $return = str_replace( array( "\r\n", "\r" ), "\n", $return);   // 改行方法の統一
     }
     echo $return;
@@ -31 +31 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfSetCsv
- * [³µÍ×] °ú¿ô¤ÎÇÛÎó¤òCSV·Á¼°¤ËÊÑ´¹¤¹¤ë
- * [°ú¿ô] 1:CSV¤Ë¤¹¤ëÇÛÎó 2:°ú¿ô1¤¬Ï¢ÁÛÇÛÎó»þ¤Îź¤¨»ú¤ò»ØÄꤷ¤¿ÇÛÎó
- * [ÌáÃÍ] CSV¥Ç¡¼¥¿
- * [°Í¸] -
- * [Ãí¼á] -
+ * [名称] gfSetCsv
+ * [概要] 引数の配列をCSV形式に変換する
+ * [引数] 1:CSVにする配列 2:引数1が連想配列時の添え字を指定した配列
+ * [戻値] CSVデータ
+ * [依存] -
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gfSetCsv( $array, $arrayIndex = "" ){  
-    //°ú¿ô$arrayIndex¤Ï¡¢$array¤¬Ï¢ÁÛÇÛÎó¤Î¤È¤­¤Ëź¤¨»ú¤ò»ØÄꤷ¤Æ¤ä¤ë¤¿¤á¤Ë»ÈÍѤ¹¤ë
+    //引数$arrayIndexは、$arrayが連想配列のときに添え字を指定してやるために使用する
     
     $return = "";
@@ -48 +48 @@
             $return .= "\"";            
             if ( $arrayIndex ){
-                $return .= mb_ereg_replace("<","¡ã",mb_ereg_replace( "\"","\"\"",$array[$i][$arrayIndex[$j]] )) ."\"";          
+                $return .= mb_ereg_replace("<","＜",mb_ereg_replace( "\"","\"\"",$array[$i][$arrayIndex[$j]] )) ."\"";           
             } else {
-                $return .= mb_ereg_replace("<","¡ã",mb_ereg_replace( "\"","\"\"",$array[$i][$j] )) ."\"";
+                $return .= mb_ereg_replace("<","＜",mb_ereg_replace( "\"","\"\"",$array[$i][$j] )) ."\"";
             }
         }
@@ -60 +60 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfGetAge
- * [³µÍ×] ÆüÉÕ¤è¤êǯÎð¤ò·×»»¤¹¤ë¡£
- * [°ú¿ô] 1:ÆüÉÕʸ»úÎó(yyyy/mm/dd¡¢yyyy-mm-dd hh:mm:ssÅù)
- * [ÌáÃÍ] ǯÎð¤Î¿ôÃÍ
- * [°Í¸] -
- * [Ãí¼á] -
+ * [名称] gfGetAge
+ * [概要] 日付より年齢を計算する。
+ * [引数] 1:日付文字列(yyyy/mm/dd、yyyy-mm-dd hh:mm:ss等)
+ * [戻値] 年齢の数値
+ * [依存] -
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gfGetAge($dbdate)
@@ -79 +79 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfDebugLog
- * [³µÍ×] ¥í¥°¥Õ¥¡¥¤¥ë¤ËÊÑ¿ô¤Î¾ÜºÙ¤ò½ÐÎϤ¹¤ë¡£
- * [°ú¿ô] ÂоݤȤʤëÊÑ¿ô
- * [ÌáÃÍ] ¤Ê¤·
- * [°Í¸] gfPrintLog
- * [Ãí¼á] -
+ * [名称] gfDebugLog
+ * [概要] ログファイルに変数の詳細を出力する。
+ * [引数] 対象となる変数
+ * [戻値] なし
+ * [依存] gfPrintLog
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gfDebugLog($obj){
@@ -97 +97 @@
         gfPrintLog("*** end Debug ***");
 
-        // ¥í¥°¥Æ¡¼¥·¥ç¥ó
+        // ログテーション
         gfLogRotation(MAX_LOG_QUANTITY, MAX_LOG_SIZE, LOG_PATH);
 }
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfPrintLog
- * [³µÍ×] ¥í¥°¥Õ¥¡¥¤¥ë¤ËÆü»þ¡¢½èÍý¥Õ¥¡¥¤¥ë̾¡¢¥á¥Ã¥»¡¼¥¸¤ò½ÐÎÏ
- * [°ú¿ô] ɽ¼¨¤·¤¿¤¤¥á¥Ã¥»¡¼¥¸
- * [ÌáÃÍ] ¤Ê¤·
- * [°Í¸] ¤Ê¤·
- * [Ãí¼á] -
+ * [名称] gfPrintLog
+ * [概要] ログファイルに日時、処理ファイル名、メッセージを出力
+ * [引数] 表示したいメッセージ
+ * [戻値] なし
+ * [依存] なし
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gfPrintLog($mess, $path = '') {
-    // ÆüÉդμèÆÀ
+    // 日付の取得
     $today = date("Y/m/d H:i:s");
-    // ½ÐÎϥѥ¹¤ÎºîÀ®
+    // 出力パスの作成
     if ($path == "") {
         $path = LOG_PATH;
     }
 
-    // ¥¨¥¹¥±¡¼¥×¤µ¤ì¤Æ¤¤¤ëʸ»ú¤ò¤â¤È¤ËÌ᤹
+    // エスケープされている文字をもとに戻す
     $trans_tbl = get_html_translation_table (HTML_ENTITIES);
     $trans_tbl = array_flip ($trans_tbl);
@@ -128 +128 @@
     }
     
-    // ¥í¥°¥Æ¡¼¥·¥ç¥ó
+    // ログテーション
     gfLogRotation(MAX_LOG_QUANTITY, MAX_LOG_SIZE, $path);
 }
 
 /**         
- * ¥í¥°¥í¡¼¥Æ¡¼¥·¥ç¥óµ¡Ç½           
+ * ログローテーション機能          
  *          
- * @param integer $max_log ºÇÂç¥Õ¥¡¥¤¥ë¿ô
- * @param integer $max_size ºÇÂ祵¥¤¥º
- * @param string  $path ¥Õ¥¡¥¤¥ë¥Ñ¥¹
- * @return void ¤Ê¤·
+ * @param integer $max_log 最大ファイル数
+ * @param integer $max_size 最大サイズ
+ * @param string  $path ファイルパス
+ * @return void なし
  */         
 function gfLogRotation($max_log, $max_size, $path) {
     
-    // ¥Ç¥£¥ì¥¯¥È¥ê̾¤ò¼èÆÀ
+    // ディレクトリ名を取得
     $dirname = dirname($path);
-    // ¥Õ¥¡¥¤¥ë̾¤ò¼èÆÀ
+    // ファイル名を取得
     $basename = basename($path);
     
-    // ¥Õ¥¡¥¤¥ë¤¬ºÇÂ祵¥¤¥º¤òĶ¤¨¤Æ¤¤¤Ê¤¤¤«¥Á¥§¥Ã¥¯
+    // ファイルが最大サイズを超えていないかチェック
     if(filesize($path) > $max_size) {
         if ($dh = opendir($dirname)) {
             while (($file = readdir($dh)) !== false) {
-                // ¥í¥°¥í¡¼¥Æ¡¼¥·¥ç¥ó¤Ë¤ÆºîÀ®¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤ò¼èÆÀ
+                // ログローテーションにて作成されたファイルを取得
                 if(ereg("^". $basename . "\." , $file)) {
                     $arrLog[] = $file;
@@ -157 +157 @@
             }
             
-            // ¥Õ¥¡¥¤¥ë¥í¥°¤¬ºÇÂç¸Ä¿ô¤Ê¤é°Ê¾å¤Ê¤é¸Å¤¤¥Õ¥¡¥¤¥ë¤«¤éºï½ü¤¹¤ë
+            // ファイルログが最大個数なら以上なら古いファイルから削除する
             $count = count($arrLog);
             if($count >= $max_log) {
@@ -166 +166 @@
             }
             
-            // ¥í¥°¥Õ¥¡¥¤¥ë¤Îź¤¨»ú¤ò¤º¤é¤¹
+            // ログファイルの添え字をずらす
             $count = count($arrLog);
             for($i = $count; 1 <= $i; $i--) {
@@ -177 +177 @@
             $ret = copy($path, "$path.1");
             
-            // ¿·µ¬¥í¥°¥Õ¥¡¥¤¥ë¤òºîÀ®
+            // 新規ログファイルを作成
             if($ret) {
                 unlink($path);          
@@ -187 +187 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] gfMakePassword
- * [³µÍ×] ¥é¥ó¥À¥à¥Ñ¥¹¥ï¡¼¥ÉÀ¸À®¡Ê±Ñ¿ô»ú¡Ë
- * [°ú¿ô] ¥Ñ¥¹¥ï¡¼¥É¤Î·å¿ô
- * [ÌáÃÍ] ¥é¥ó¥À¥àÀ¸À®¤µ¤ì¤¿¥Ñ¥¹¥ï¡¼¥É
- * [°Í¸] ¤Ê¤·
- * [Ãí¼á] -
+ * [名称] gfMakePassword
+ * [概要] ランダムパスワード生成（英数字）
+ * [引数] パスワードの桁数
+ * [戻値] ランダム生成されたパスワード
+ * [依存] なし
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gfMakePassword($pwLength) {
     
-    // Íð¿ôɽ¤Î¥·¡¼¥É¤ò·èÄê
+    // 乱数表のシードを決定
     srand((double)microtime() * 54234853);
     
-    // ¥Ñ¥¹¥ï¡¼¥Éʸ»úÎó¤ÎÇÛÎó¤òºîÀ®
+    // パスワード文字列の配列を作成
     $character = "abcdefghkmnpqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ2345679";
     $pw = preg_split("//", $character, 0, PREG_SPLIT_NO_EMPTY);
@@ -212 +212 @@
 
 /*----------------------------------------------------------------------
- * [̾¾Î] sf_explodeExt
- * [³µÍ×] ¥Õ¥¡¥¤¥ë¤Î³ÈÄ¥»Ò¼èÆÀ
- * [°ú¿ô] ¥Õ¥¡¥¤¥ë̾
- * [ÌáÃÍ] ³ÈÄ¥»Ò
- * [°Í¸] ¤Ê¤·
- * [Ãí¼á] -
+ * [名称] sf_explodeExt
+ * [概要] ファイルの拡張子取得
+ * [引数] ファイル名
+ * [戻値] 拡張子
+ * [依存] なし
+ * [注釈] -
  *----------------------------------------------------------------------*/
 function gf_explodeExt($fileName) {
@@ -228 +228 @@
 
 /*----------------------------------------------------------------------------------------------------------------------
- * [̾¾Î] gfMailHeaderAddr
- * [³µÍ×] ÆþÎϤµ¤ì¤¿¥á¡¼¥ë¥¢¥É¥ì¥¹¤ò¥á¡¼¥ë´Ø¿ôÍѤΰ¸Àè¤ËÊÑ´¹
- * [°ú¿ô] ¡Ö¥á¡¼¥ë¥¢¥É¥ì¥¹¡×¤Þ¤¿¤Ï¡Ö̾Á°<¥á¡¼¥ë¥¢¥É¥ì¥¹>¡×¡¢Ê£¿ô¥¢¥É¥ì¥¹»ØÄê»þ¤Ï¥«¥ó¥Þ¶èÀÚ¤ê¤Ç»ØÄꤹ¤ë¡£
- * [ÌáÃÍ] ¡Ö¥á¡¼¥ë¥¢¥É¥ì¥¹¡×¤Þ¤¿¤Ï¡ÖJIS_MIME¤Ë¥³¡¼¥ÉÊÑ´¹¤·¤¿Ì¾Á° <¥á¡¼¥ë¥¢¥É¥ì¥¹>¡×¡¢Ê£¿ô¥¢¥É¥ì¥¹»ØÄê»þ¤Ï¥«¥ó¥Þ¶èÀÚ¤ê¤ÇÊֵѤ¹¤ë¡£
- * [°Í¸] ¤Ê¤·
- * [Ãí¼á] -
+ * [名称] gfMailHeaderAddr
+ * [概要] 入力されたメールアドレスをメール関数用の宛先に変換
+ * [引数] 「メールアドレス」または「名前<メールアドレス>」、複数アドレス指定時はカンマ区切りで指定する。
+ * [戻値] 「メールアドレス」または「JIS_MIMEにコード変換した名前 <メールアドレス>」、複数アドレス指定時はカンマ区切りで返却する。
+ * [依存] なし
+ * [注釈] -
  *----------------------------------------------------------------------------------------------------------------------*/
 
 function gfMailHeaderAddr($str) {
-    $addrs = explode(",", $str); //¥¢¥É¥ì¥¹¤òÇÛÎó¤ËÆþ¤ì¤ë
+    $addrs = explode(",", $str); //アドレスを配列に入れる
     foreach ($addrs as $addr) {
         if (preg_match("/^(.+)<(.+)>$/", $addr, $matches)) {
-            //°ú¿ô¤¬¡Ö̾Á°<¥á¡¼¥ë¥¢¥É¥ì¥¹>¡×¤Î¾ì¹ç
+            //引数が「名前<メールアドレス>」の場合
             $mailaddrs[] = mb_encode_mimeheader(trim($matches[1]))." <".trim($matches[2]).">";
         } else {
-            //¥á¡¼¥ë¥¢¥É¥ì¥¹¤Î¤ß¤Î¾ì¹ç
+            //メールアドレスのみの場合
             $mailaddrs[] =  trim($addr);
         }
     }
-    return implode(", ", $mailaddrs); //Ê£¿ô¥¢¥É¥ì¥¹¤Ï¥«¥ó¥Þ¶èÀÚ¤ê¤Ë¤¹¤ë
+    return implode(", ", $mailaddrs); //複数アドレスはカンマ区切りにする
 }
 ?>