0.2

Author: TsSaltan

README.md

@@ -1,59 +1,128 @@
 ## DevelNext Preg Bundle
 Пакет расширений для работы с функциями preg_*  оригинального php
 
+### Changelog
+```
+-- 0.2 --
+[Fix] Исправлен баг с модификаторами
+[Fix] preg_replace и preg_replace_callback поддерживают работу с массивами
+[Add] preg_split
+[Add] preg_quote
+
+-- 0.1 --
+[Add] preg_match_all
+[Add] preg_match
+[Add] preg_grep
+[Add] preg_replace
+[Add] preg_replace_callback
+```
+
+
 ### Поддерживаемые функции
 ```php
 /**
  * --RU--
- * Выполняет Выполняет глобальный поиск шаблона в строке
+ * Выполняет глобальный поиск шаблона в строке
  * 
- * @param string $pattern - Искомый шаблон
- * @param string $subject - Входная строка
- * @param array $matches = null - Параметр будет заполнен результатами поиска
- * @param int $flags = PREG_PATTERN_ORDER
- * @return int
+ * @link    http://php.net/manual/function.preg-match-all.php
+ *
+ * @param   string  $pattern  Искомый шаблон
+ * @param   string  $subject  Входная строка
+ * @param   array   $matches  (optional)  Параметр будет заполнен результатами поиска
+ * @param   int     $flags    (optional)  Возможные значения - PREG_PATTERN_ORDER, PREG_SET_ORDER
+ * @return  int
  */
 function preg_match_all($pattern, $subject, &$matches = null, $flags = PREG_PATTERN_ORDER)
 
 /**
  * --RU--
  * Выполняет проверку на соответствие регулярному выражению
  * 
- * @param string $pattern - Искомый шаблон
- * @param string $subject - Входная строка
- * @param array $matches = null - Параметр будет заполнен результатами поиска
- * @return int
+ * @link    http://php.net/manual/function.preg-match.php
+ * 
+ * @param   string  $pattern  Искомый шаблон
+ * @param   string  $subject  Входная строка
+ * @param   array   $matches  (optional)  Параметр будет заполнен результатами поиска
+ * @return  int
  */
 function preg_match($pattern, $subject, &$matches = null)
 
 /**
  * --RU--
  * Возвращает массив вхождений, которые соответствуют шаблону
  * 
- * @param string $pattern - Искомый шаблон
- * @param array $subject - Входящий массив
- * @return array
+ * @link    http://php.net/manual/function.preg-grep.php
+ * 
+ * @param   string  $pattern  Искомый шаблон
+ * @param   array   $subject  Входящий массив
+ * @param   int     $flags    (optional)  Возможное значение - PREG_GREP_INVERT
+ * @return  array
  */
 function preg_grep($pattern, $input, $flags = 0)
 
 /**
  * --RU--
  * Выполняет поиск и замену по регулярному выражению
  * 
- * @param mixed $pattern - Искомый шаблон. Может быть как строкой, так и массивом строк.
- * @param callable $callback - Вызываемая callback-функция function( array $matches )
- * @param mixed $subject - Строка или массив строк для поиска и замены
- * @return string
+ * @link    http://php.net/manual/function.preg-replace.php
+ * 
+ * @param   mixed  $pattern      Искомый шаблон. Может быть как строкой, так и массивом строк.
+ * @param   mixed  $replacement  Строка или массив строк для замены
+ * @param   mixed  $subject      Строка или массив строк для поиска и замены
+ * @return  mixed  Строка или массив, в зависимости от параметра $subject
  */
 function preg_replace($pattern, $replacement, $subject)
 
 /**
  * --RU--
  * Выполняет поиск по регулярному выражению и замену с использованием callback-функции
  * 
- * @param string $pattern - Искомый шаблон
- * @param callable $callback - Вызываемая callback-функция function( array $matches )
- * @param string $subject - Строка для поиска и замены
+ * @link    http://php.net/manual/function.preg-replace-callback.php
+ * 
+ * @param   mixed     $pattern   Искомый шаблон (строка или массив)
+ * @param   callable  $callback  Вызываемая callback-функция function( array $matches )
+ * @param   mixed     $subject   Строка или массив для поиска и замены
+ * @return  mixed     Строка или массив, в зависимости от параметра $subject
  */
 function preg_replace_callback($pattern, $callback, $subject)
+
+/**
+ * --RU--
+ * Разбивает строку по регулярному выражению
+ * 
+ * @link    http://php.net/manual/function.preg-split.php
+ * 
+ * @param   string  $pattern  Строка, содержащая искомый шаблон.
+ * @param   mixed   $subject  Входная строка
+ * @param   int     $limit    (optional)  Если указан, функция возвращает не более, чем limit подстрок
+ * @return  array
+ */
+function preg_split($pattern, $subject, $limit = 0)
+
+/**
+ * --RU--
+ * Экранирует символы в регулярных выражениях
+ * 
+ * @link    http://php.net/manual/function.preg-quote.php
+ * 
+ * @param   string  $str        Входная строка
+ * @param   string  $delimiter  (optional)  Символ, который будет также экранироваться
+ * @return  string
+ */
+ function preg_quote($str, $delimiter = null)
+```
+
+### Поддерживаемые модификаторы
+```
+i (php - PCRE_CASELESS, jphp - CASE_INSENSITIVE)
+Если этот модификатор используется, символы в шаблоне соответствуют символам как верхнего, так и нижнего регистра.
+
+m (php - PCRE_MULTILINE, jphp - MULTILINE)
+Многострочный поиск
+
+s (php - PCRE_DOTALL, jphp - DOTALL)
+Если данный модификатор используется, метасимвол "точка" в шаблоне соответствует всем символам, включая перевод строк. Без него - всем, за исключением переводов строк. Этот модификатор эквивалентен записи /s в Perl. Класс символов, построенный на отрицании, например [^a], всегда соответствует переводу строки, независимо от наличия этого модификатора.
+
+u (php - PCRE_UTF8, jphp - UNICODE_CASE)
+Этот модификатор включает дополнительную функциональность: шаблон и целевая строка обрабатываются как UTF-8 строки.
 ```

src/.resource

@@ -6,4 +6,4 @@ icon=develnext/bundle/preg/preg.png
 
 class=develnext\\bundle\\preg\\pregBundle
 author=Ts.Saltan
-version=0.1
+version=0.2

src/develnext/bundle/preg/description.html

@@ -1,4 +1,10 @@
 <ul>
-    <li><code>bundle\preg\Preg</code> <i>(основной функционал, адаптер под preg_* функции)</i></li>
-    <li><code>preg</code> <i>(поддержка preg_* функций)</i></li>
+    <li><code>bundle\preg\Preg</code> - <i>адаптер regex для preg_* функций</i></li>
+    <li><code>preg_grep</code> <i></li>
+    <li><code>preg_match_all</code> <i></li>
+    <li><code>preg_match</code> <i></li>
+    <li><code>preg_replace</code> <i></li>
+    <li><code>preg_replace_callback</code> <i></li>
+    <li><code>preg_split</code> <i></li>
+    <li><code>preg_quote</code> <i></li>
 </ul>

src/vendor/develnext.bundle.preg.pregBundle/bundle/preg/Preg.php

@@ -19,9 +19,13 @@ public function __construct($pattern = null, $subject = null){
 
     public function setSubject($subject){
         $this->subject = (string) $subject;
-        Logger::debug('subject = '.var_export($subject, true));
+        $this->log('subject = ', $subject);
     }
 
+    public function getPattern(){
+        return $this->pattern;
+    }
+
     public function setPattern($pattern){
         $delim = substr($pattern, 0, 1);
         $endReg = str::lastPos($pattern, $delim);
@@ -33,9 +37,9 @@ public function setPattern($pattern){
         if(substr($this->pattern, 0, 1) == '^')$this->pattern = substr($this->pattern, 1);
         if(substr($this->pattern, -1) == '$')$this->pattern = substr($this->pattern, 0, -1);
 
-        Logger::debug('pattern = '.var_export($this->pattern, true));
-        Logger::debug('modifs = '.var_export($modifs, true));
-        Logger::debug('flags = '.var_export($this->flags, true));
+        $this->log('pattern = '. $this->pattern);
+        $this->log('modifs = ',$modifs);
+        $this->log('flags = '. $this->flags);
 
         return $this;
     }
@@ -75,15 +79,15 @@ protected function parseModifiers($modifiers){
 
         foreach($modifiers as $m){
             if(isset($mods[$m])){
-                $this->flags &= $mods[$m];
+                $this->flags |= $mods[$m];
             }
         }
     }
 
     public function count(){
         return $this->reg->getGroupCount() + 1;
     }
-        
+
     public function matches(){
         $return = [];
         for($i = 0; $i < $this->count(); ++$i){
@@ -92,4 +96,23 @@ public function matches(){
 
         return $return;
     }
+
+    const LOG = false;
+    private function log(...$args){
+        if(self::LOG !== true) return;
+        $message = '';
+        //$args = func_get_args();
+        foreach($args as $arg){
+            if(is_string($arg)){
+                $message.=$arg;
+            } else {
+                $message.=var_export($arg, true);
+            }
+        }
+
+        $lines = explode("\n", trim($message));
+        foreach ($lines as $line){
+            Logger::Debug('[Preg] ' . $line);
+        }
+    }
 }