Changeset 15078 for branches/feature-module-update/data/class/GC_MobileUserAgent.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/class/GC_MobileUserAgent.php (modified) (7 diffs)

branches/feature-module-update/data/class/GC_MobileUserAgent.php

@@ -10 +10 @@
 
 /**
- * ·ÈÂÓüËö¤Î¾ðÊó¤ò°·¤¦¥¯¥é¥¹
+ * 携帯端末の情報を扱うクラス
  *
- * ÂоݤȤ¹¤ë·ÈÂÓüËö¤Ï $_SERVER ¤«¤é·èÄꤹ¤ë¡£
- * ¤¹¤Ù¤Æ¤Î¥á¥½¥Ã¥É¤Ï¥¯¥é¥¹¥á¥½¥Ã¥É¡£
+ * 対象とする携帯端末は $_SERVER から決定する。
+ * すべてのメソッドはクラスメソッド。
  */
 class GC_MobileUserAgent {
     /**
-     * ·ÈÂÓüËö¤Î¥­¥ã¥ê¥¢¤òɽ¤¹Ê¸»úÎó¤ò¼èÆÀ¤¹¤ë¡£
+     * 携帯端末のキャリアを表す文字列を取得する。
      *
-     * ʸ»úÎó¤Ï docomo, ezweb, softbank ¤Î¤¤¤º¤ì¤«¡£
+     * 文字列は docomo, ezweb, softbank のいずれか。
      *
-     * @return string|false ·ÈÂÓüËö¤Î¥­¥ã¥ê¥¢¤òɽ¤¹Ê¸»úÎó¤òÊÖ¤¹¡£
-     *                      ·ÈÂÓüËö¤Ç¤Ï¤Ê¤¤¾ì¹ç¤Ï false ¤òÊÖ¤¹¡£
+     * @return string|false 携帯端末のキャリアを表す文字列を返す。
+     *                      携帯端末ではない場合は false を返す。
      */
     function getCarrier() {
@@ -43 +43 @@
 
     /**
-     * ¾¡¼ê¥µ¥¤¥È¤ÇÍøÍѲÄǽ¤Ê·ÈÂÓüËö/ÍøÍѼԤÎID¤ò¼èÆÀ¤¹¤ë¡£
+     * 勝手サイトで利用可能な携帯端末/利用者のIDを取得する。
      *
-     * ³Æ¥­¥ã¥ê¥¢¤Ç»ÈÍѤ¹¤ëID¤Î¼ïÎà:
+     * 各キャリアで使用するIDの種類:
      * + docomo   ... UTN
-     * + ezweb    ... EZÈÖ¹æ
-     * + softbank ... üËö¥·¥ê¥¢¥ëÈÖ¹æ
+     * + ezweb    ... EZ番号
+     * + softbank ... 端末シリアル番号
      *
-     * @return string|false ¼èÆÀ¤·¤¿ID¤òÊÖ¤¹¡£¼èÆÀ¤Ç¤­¤Ê¤«¤Ã¤¿¾ì¹ç¤Ï false ¤òÊÖ¤¹¡£
+     * @return string|false 取得したIDを返す。取得できなかった場合は false を返す。
      */
     function getId() {
@@ -65 +65 @@
 
     /**
-     * ·ÈÂÓüËö¤Îµ¡¼ï¤òɽ¤¹Ê¸»úÎó¤ò¼èÆÀ¤¹¤ë¡£
-     * ·ÈÂÓüËö¤Ç¤Ï¤Ê¤¤¾ì¹ç¤Ï¥æ¡¼¥¶¡¼¥¨¡¼¥¸¥§¥ó¥È¤Î̾Á°¤ò¼èÆÀ¤¹¤ë¡£(Îã: "Mozilla")
+     * 携帯端末の機種を表す文字列を取得する。
+     * 携帯端末ではない場合はユーザーエージェントの名前を取得する。(例: "Mozilla")
      *
-     * @return string ·ÈÂÓüËö¤Î¥â¥Ç¥ë¤òɽ¤¹Ê¸»úÎó¤òÊÖ¤¹¡£
+     * @return string 携帯端末のモデルを表す文字列を返す。
      */
     function getModel() {
@@ -82 +82 @@
 
     /**
-     * EC-CUBE ¤¬¥µ¥Ý¡¼¥È¤¹¤ë·ÈÂÓ¥­¥ã¥ê¥¢¤«¤É¤¦¤«¤òȽÊ̤¹¤ë¡£
+     * EC-CUBE がサポートする携帯キャリアかどうかを判別する。
      *
-     * @return boolean ¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¾ì¹ç¤Ï true¡¢¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï false ¤òÊÖ¤¹¡£
+     * @return boolean サポートしている場合は true、それ以外の場合は false を返す。
      */
     function isMobile() {
@@ -96 +96 @@
 
     /**
-     * EC-CUBE ¤¬¥µ¥Ý¡¼¥È¤¹¤ë·ÈÂÓ¥­¥ã¥ê¥¢¤«¤É¤¦¤«¤òȽÊ̤¹¤ë¡£
+     * EC-CUBE がサポートする携帯キャリアかどうかを判別する。
      *
-     * @return boolean ·ÈÂÓüËö¤Ç¤Ï¤Ê¤¤¾ì¹ç¤Ï true¡¢¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï false ¤òÊÖ¤¹¡£
+     * @return boolean 携帯端末ではない場合は true、それ以外の場合は false を返す。
      */
     function isNonMobile() {
@@ -105 +105 @@
 
     /**
-     * EC-CUBE ¤¬¥µ¥Ý¡¼¥È¤¹¤ë·ÈÂÓüËö¤«¤É¤¦¤«¤òȽÊ̤¹¤ë¡£
+     * EC-CUBE がサポートする携帯端末かどうかを判別する。
      *
-     * @return boolean ¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¾ì¹ç¤Ï true¡¢¤½¤ì°Ê³°¤Î¾ì¹ç¤Ï false ¤òÊÖ¤¹¡£
+     * @return boolean サポートしている場合は true、それ以外の場合は false を返す。
      */
     function isSupported() {
         $objAgent =& Net_UserAgent_Mobile::singleton();
 
-        // ·ÈÂÓüËö¤À¤Èǧ¼±¤µ¤ì¤¿¤¬¡¢User-Agent ¤Î·Á¼°¤¬Ì¤ÃΤξì¹ç
+        // 携帯端末だと認識されたが、User-Agent の形式が未知の場合
         if (Net_UserAgent_Mobile::isError($objAgent)) {
             gfPrintLog($objAgent->toString());
@@ -127 +127 @@
             return $objAgent->isPacketCompliant();
         } else {
-            // ·ÈÂÓüËö¤Ç¤Ï¤Ê¤¤¾ì¹ç¤Ï¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤ë¤³¤È¤Ë¤¹¤ë¡£
+            // 携帯端末ではない場合はサポートしていることにする。
             return true;
         }