initial commit

lib/symfony/util/sfInflector.class.php

@@ -0,0 +1,118 @@
+<?php
+
+/*
+ * This file is part of the symfony package.
+ * (c) 2004-2006 Fabien Potencier <fabien.potencier@symfony-project.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+/**
+ *
+ * @package    symfony
+ * @subpackage util
+ * @author     Fabien Potencier <fabien.potencier@symfony-project.com>
+ * @version    SVN: $Id: sfInflector.class.php 1415 2006-06-11 08:33:51Z fabien $
+ */
+class sfInflector
+{
+  /**
+   * Returns a camelized string from a lower case and underscored string by replaceing slash with
+   * double-colol and upper-casing each letter preceded by an underscore.
+   *
+   * @param string String to camelize.
+   *
+   * @return string Camelized string.
+   */
+  public static function camelize($lower_case_and_underscored_word)
+  {
+    $tmp = $lower_case_and_underscored_word;
+    $tmp = sfToolkit::pregtr($tmp, array('#/(.?)#e'    => "'::'.strtoupper('\\1')",
+                                         '/(^|_)(.)/e' => "strtoupper('\\2')"));
+
+    return $tmp;
+  }
+
+  /**
+   * Returns an underscore-syntaxed version or the CamelCased string.
+   *
+   * @param string String to underscore.
+   *
+   * @return string Underscored string.
+   */
+  public static function underscore($camel_cased_word)
+  {
+    $tmp = $camel_cased_word;
+    $tmp = str_replace('::', '/', $tmp);
+    $tmp = sfToolkit::pregtr($tmp, array('/([A-Z]+)([A-Z][a-z])/' => '\\1_\\2',
+                                         '/([a-z\d])([A-Z])/'     => '\\1_\\2'));
+
+    return strtolower($tmp);
+  }
+
+  /**
+   * Returns classname::module with classname:: stripped off.
+   *
+   * @param string Classname and module pair.
+   *
+   * @return string Module name.
+   */
+  public static function demodulize($class_name_in_module)
+  {
+    return preg_replace('/^.*::/', '', $class_name_in_module);
+  }
+
+  /**
+   * Returns classname in underscored form, with "_id" tacked on at the end.
+   * This is for use in dealing with foreign keys in the database.
+   *
+   * @param string Class name.
+   * @param boolean Seperate with underscore.
+   *
+   * @return strong Foreign key
+   */
+  public static function foreign_key($class_name, $separate_class_name_and_id_with_underscore = true)
+  {
+    return sfInflector::underscore(sfInflector::demodulize($class_name)).($separate_class_name_and_id_with_underscore ? "_id" : "id");
+  }
+
+  /**
+   * Returns corresponding table name for given classname.
+   *
+   * @param string Name of class to get database table name for.
+   *
+   * @return string Name of the databse table for given class.
+   */
+  public static function tableize($class_name)
+  {
+    return sfInflector::underscore($class_name);
+  }
+
+  /**
+   * Returns model class name for given database table.
+   *
+   * @param string Table name.
+   *
+   * @return string Classified table name.
+   */
+  public static function classify($table_name)
+  {
+    return sfInflector::camelize($table_name);
+  }
+
+  /**
+   * Returns a human-readable string from a lower case and underscored word by replacing underscores
+   * with a space, and by upper-casing the initial characters.
+   *
+   * @param string String to make more readable.
+   *
+   * @return string Human-readable string.
+   */
+  public static function humanize($lower_case_and_underscored_word)
+  {
+    if (substr($lower_case_and_underscored_word, -3) === '_id')
+        $lower_case_and_underscored_word = substr($lower_case_and_underscored_word, 0, -3);
+    return ucfirst(str_replace('_', ' ', $lower_case_and_underscored_word));
+  }
+}