PHP в SouthPark » Helpers http://php.southpark.com.ua Хитрости и секреты CakePHP Mon, 07 Jun 2010 09:41:42 +0000 http://wordpress.org/?v=2.9.2 en hourly 1 ProgressBar для CakePHP в стиле WinRAR http://php.southpark.com.ua/2007/progressbar-dlya-cakephp-v-stile-winrar/ http://php.southpark.com.ua/2007/progressbar-dlya-cakephp-v-stile-winrar/#comments Tue, 27 Nov 2007 18:56:12 +0000 Владимир Лучанинов http://php.southpark.com.ua/2007/11/27/progressbar-dlya-cakephp-v-stile-winrar/ Я так люблю CakePHP, что часто мучаю его так, как и не догадывались его создатели. Некоторые задачи у меня выполняются по несколько часов так как приходится обрабатывать огромные таблицы. При этом возникают проблемы - Request Time-out, который появляется, если долго ничего не выдавать браузеру. Я раньше выводил точки, потом номер обрабатываемой записи. Для того, чтобы просмотреть, сколько уже сделано, надо было скроллить в самый низ, который постоянно исчезал.

Сегодня мне это наконец надоело и я сделал привычный ProgressBar.

Хочу, чтобы можно было писать

plain text
PHP:
  1. $countCustomers = count($customers);
  2. for ($i=0; $i<$countCustomers; $i++) {
  3.     $this->jsProgressBar($i/$countCustomers);
  4.  
  5.     $this->Customer->process($customers[$i]);
  6. }

и мне выводился красивый ProgressBar.
loading2.gif
Обратите внимание на "Loading..." сверху. Это показывает, что страница ещё грузится.

А ещё чтобы можно было писать

plain text
PHP:
  1. $this->jsProgressBar($i/$countCustomers, sprintf('Customer %s/%s', $i+1, $countCustomers));

и под ProgressBar выводилось что-то вроде "Customer 17/83".

А чтобы совсем отбить желание что-то хотеть, так чтобы можно было выводить несколько ProgressBar

plain text
PHP:
  1. $countCustomers = count($customers);
  2. for ($i=0; $i<$countCustomers; $i++) {
  3.     $this->jsProgressBar($i/$countCustomers, sprintf('Customer %s/%s', $i+1, $countCustomers));
  4.  
  5.     $orders = $this->Customer->orders($customers[$i]);
  6.     $countOrders = count($orders);
  7.    
  8.     for ($j=0; $j<$countOrders; $j++) {
  9.         $this->jsProgressBar($i/$countOrders, sprintf('Order %s/%s', $j+1, $countOrders), 'orders');
  10.         $this->Customer->Order->process($orders[$j]);
  11.     }
  12. }

Примерно так:
loading.gif

Чтобы добиться такой красоты, добавьте функцию в app_controller.php

plain text
PHP:
  1. /**
  2. * Shows and updates progress bar for long-processing actions
  3. *
  4. * @param float $ratio 0<ratio<1; 0=0%, 1=100%
  5. * @param string $status optional. If you have something to show under progress bar
  6. * @param string $name name of the progress bar if you need more than one
  7. */
  8. function jsProgressBar($ratio=0, $status=null, $name='default') {
  9.     static $inited = array();
  10.     $percents = round(100*$ratio);
  11.  
  12.     // common for all progress bars
  13.     if (empty($inited)) {
  14.         e('
  15.             <style>
  16.                 div.progressbar {
  17.                     border:1px solid #06d;
  18.                     width: 75%
  19.                 }
  20.                 div.progressbar div {
  21.                     height:1.2em;
  22.                     line-height:1.2em;
  23.                     background-color:#03a;
  24.                     border-right:1px solid #03a;
  25.                     text-align:right; color:#fff;
  26.                     width:0;
  27.                     overflow:hidden;
  28.                     padding-right: 5px
  29.                 }
  30.             </style>
  31.             <body>
  32.         ');
  33.     }
  34.  
  35.     // init current progress bar if needed
  36.     if (!in_array($name, $inited)) {
  37.         e('
  38.             <div class="progressbar"><div id="progressbar-'.$name.'"></div></div>
  39.             <div class="statusbar" id="statusbar-'.$name.'"></div>
  40.         ');
  41.         flush();ob_flush();
  42.  
  43.         $inited[] = $name;
  44.     }
  45.  
  46.     // set current position
  47.     if ($status===null) {
  48.         $statusScript = '';
  49.     } else {
  50.         $statusScript = 'document.getElementById("statusbar-'.$name.'").innerHTML = "'.$status.'";';
  51.     }
  52.  
  53.     e('
  54.         <script>
  55.             var progress = document.getElementById("progressbar-'.$name.'");
  56.             var percent = '.$percents.'+"%";
  57.             progress.innerHTML = percent;
  58.             progress.style.width = percent;
  59.             '.$statusScript.'
  60.         </script>
  61.     ');
  62.     flush();ob_flush();
  63. }

Идея в том, чтобы выводить скрипт, который будет менять значение и форматирование определённого div.

Кстати, если вывести какой-то текст, то $this->redirect в контроллере уже не будет работать как и все проявления header() вроде $this->Session->setFlash(). Поэтому, если нужен setFlash, то делайте его до jsProgressBar.

А чтобы сделать redirect, я написал ещё одну маленькую приятность.

plain text
PHP:
  1. function jsRedirect($url) {
  2.     printf('<script>window.location="%s"</script>', Router::url($url, true));
  3.     exit;
  4. }

URL в неё можно передавать в том же формате, как и для обычного $this->redirect, то есть подходит как '/customers/', так и array('action'=>'index'). В конце вместо

plain text
PHP:
  1. $this->redirect('/', null, true);

пишите

plain text
PHP:
  1. $this->jsRedirect(array('action'=>'index'));

]]> http://php.southpark.com.ua/2007/progressbar-dlya-cakephp-v-stile-winrar/feed/ 5 Хлебные крошки в CakePHP http://php.southpark.com.ua/2007/cakephp-breadcrumbs/ http://php.southpark.com.ua/2007/cakephp-breadcrumbs/#comments Mon, 26 Nov 2007 22:17:46 +0000 Владимир Лучанинов http://php.southpark.com.ua/2007/11/26/cakephp-breadcrumbs/ "Хлебные крошки" - это удобный способ навигации, который к тому же даёт понять текущее положение на сайте. Для моего текущего проекта этот способ очень упрощает использование. Я задумался, как сделать это наиболее красиво в CakePHP.

На Bakery нашёл только этот ужас. К тому же, это больше подходит под Element, а не Helper. Если сделать Element, то во View можно будет писать

plain text
PHP:
  1. <?=$this->renderElement('breadcrumbs', array('items'=> array(
  2.     $html->link('Site group', array('controller'=>'site_groups', 'action'=>'edit', $this->data['Site']['site_group_id'])),
  3.     $html->link('Site', array('controller'=>'sites', 'action'=>'edit', $site['Site']['id'])),
  4.     'Page'
  5. )))?>

Это значит, что мы находимся в разделе "SiteGroup / Site / Page", причём на SiteGroup и Site можно перейти, нажав на ссылки.

breadcrumbs.jpg

Меня наши верстальщики умудрились достать по поводу корректости кода, разделения контента и представления. По их мнению, это список, а список делается с помощью ul-li, а не просто через пробел. Поэтому получается такой Element:

app\views\elements\breadcrumbs.ctp

plain text
PHP:
  1. <? if (empty($separator)) $separator = '&#187; ' ?>
  2. <div id="breadcrumbs">
  3.     <ul>
  4.         <li class="first"><?=$html->link('Home', '/')?></li>
  5.         <? if (!empty($items) && is_array($items)) foreach ($items as $item): ?>
  6.             <li><?=$separator.$item?></li>
  7.         <? endforeach ?>
  8.     </ul>
  9. </div>

Можно было бы обойтись без обрамляющего div, но он оставлен для универсальности на случай сложной кроссбраузерной вёрстки. Теперь осталось сделать CSS, чтобы "хлебные крошки" выводились слева направо, а не сверху вниз.

plain text
CSS:
  1. #breadcrumbs {
  2.     color: #333;
  3.     padding: 0;
  4.     margin-bottom: 15px;
  5.     font-size: smaller;
  6. }
  7.  
  8. #breadcrumbs ul {
  9.     margin: 0;
  10.     padding: 0;
  11.     display: inline;
  12. }
  13.  
  14. #breadcrumbs ul li {
  15.     margin: 0;
  16.     padding-left: 2px;
  17.     border: none;
  18.     list-style: none;
  19.     display: inline;
  20. }
  21.  
  22. #breadcrumbs ul li a {
  23.     text-decoration: none;
  24. }
  25.  
  26. #breadcrumbs ul li a:hover {
  27.     text-decoration: underline;
  28. }

Этот CSS подключается после стандартного cake.generic.css.

]]> http://php.southpark.com.ua/2007/cakephp-breadcrumbs/feed/ 14 Вывод из PHP в Firebug. Helper для CakePHP http://php.southpark.com.ua/2007/vyvod-iz-php-v-firebug-helper-dlya-cakephp/ http://php.southpark.com.ua/2007/vyvod-iz-php-v-firebug-helper-dlya-cakephp/#comments Wed, 17 Oct 2007 12:22:27 +0000 Владимир Лучанинов http://php.southpark.com.ua/2007/10/17/vyvod-iz-php-v-firebug-helper-dlya-cakephp/ Как вы делаете отладку? В запутанных случаях я использую Zend Debugger, а в простых случаях пишу pr($variable).

Прочитав Ярослава, я вдруг осознал насколько удобно было бы не мусорить окно браузера, а красиво выводить отладочные сообщения в Firebug. Особенно приятно туда выводить сложные объекты и большие массивы так как Firebug позволяет удобно такие вещи просматривать.

Но реализация от Ярослава мне не подходит.
Там много всяких полезностей, но мне они не нужны :) . Схожие функции выполняет будет когда-то выполнять дополнительная панель к Firebug - FirePHP. Но это совсем уже монстр, к тому же пока очень бета. Может, когда его доработают, то я себе установлю.

А пока мне просто нужно писать во View

plain text
PHP:
  1. <?=$jsDebug->console($strangeVariable)?>

, где переменная может быть как целым числом, так и сложным массивом или объектом. Это перекрывает 90% потребностей. Бонусом является возможность добавления стандартных иконок Firebug (warn, info, error) и иногда устанавливать переменную javascipt, чтобы потом javascriptом её и обрабатывать. А для тех, у кого нет Firebug, можно использовать метод alert.

Как обычно начинаем с теста, который покажет как использовать этот helper

plain text
PHP:
  1. <?
  2.  
  3. loadHelper('JsDebug');
  4.  
  5. class JsDebugTest extends UnitTestCase {
  6.     var $helper = null;
  7.  
  8.     function setUp() {
  9.         $this->helper = new JsDebugHelper();
  10.     }
  11.  
  12.     function testConsole() {
  13.         $result = $this->helper->console('');
  14.         $this->assertEqual('<script type="text/javascript">console.log(eval(""))</script>', $result);
  15.  
  16.         $result = $this->helper->console('1');
  17.         $this->assertEqual('<script type="text/javascript">console.log(eval("1"))</script>', $result);
  18.  
  19.         $result = $this->helper->console(array(1,2,3));
  20.         $this->assertEqual('<script type="text/javascript">console.log(eval([1,2,3]))</script>', $result);
  21.  
  22.         $result = $this->helper->console(array('one'=>'test','two'=>array(1,2,3),3));
  23.         $this->assertEqual('<script type="text/javascript">console.log(eval({"one":"test","two":[1,2,3],"0":3}))</script>', $result);
  24.     }
  25.  
  26.     function testConsoleTypes() {
  27.         $result = $this->helper->console('1', 'info');
  28.         $this->assertEqual('<script type="text/javascript">console.info(eval("1"))</script>', $result);
  29.  
  30.         $result = $this->helper->info('1');
  31.         $this->assertEqual('<script type="text/javascript">console.info(eval("1"))</script>', $result);
  32.  
  33.         $result = $this->helper->warn('1');
  34.         $this->assertEqual('<script type="text/javascript">console.warn(eval("1"))</script>', $result);
  35.  
  36.         $result = $this->helper->error('1');
  37.         $this->assertEqual('<script type="text/javascript">console.error(eval("1"))</script>', $result);
  38.     }
  39.  
  40.     function testSet() {
  41.         $result = $this->helper->set('', 'test');
  42.         $this->assertEqual('<script type="text/javascript">var test = eval("")</script>', $result);
  43.  
  44.         $result = $this->helper->set('1', 'test');
  45.         $this->assertEqual('<script type="text/javascript">var test = eval("1")</script>', $result);
  46.  
  47.         $result = $this->helper->set(array(1,2,3), 'test');
  48.         $this->assertEqual('<script type="text/javascript">var test = eval([1,2,3])</script>', $result);
  49.  
  50.         $result = $this->helper->set(array('one'=>'test','two'=>array(1,2,3),3), 'test');
  51.         $this->assertEqual('<script type="text/javascript">var test = eval({"one":"test","two":[1,2,3],"0":3})</script>', $result);
  52.     }
  53.  
  54.     function testAlert() {
  55.         $result = $this->helper->alert('');
  56.         $this->assertEqual('<script type="text/javascript">alert(\'\')</script>', $result);
  57.  
  58.         $result = $this->helper->alert('1');
  59.         $this->assertEqual('<script type="text/javascript">alert(\'1\')</script>', $result);
  60.  
  61.         $result = $this->helper->alert(array(1,2,3));
  62.         $this->assertEqual('<script type="text/javascript">alert(\'Array\n(\n    [0] => 1\n    [1] => 2\n    [2] => 3\n)\n\')</script>', $result);
  63.  
  64.         $result = $this->helper->alert(array('one'=>'test','two'=>array(1,2,3),3));
  65.         $this->assertEqual('<script type="text/javascript">alert(\'Array\n(\n    [one] => test\n    [two] => Array\n        (\n            [0] => 1\n            [1] => 2\n            [2] => 3\n        )\n\n    [0] => 3\n)\n\')</script>', $result);
  66.     }
  67.  
  68.     function tearDown() {
  69.         unset($this->helper);
  70.     }
  71. }
  72.  
  73.  
  74. ?>

А вот и сам helper

plain text
PHP:
  1. <?
  2.  
  3. /**
  4. * JsDebug helper
  5. *
  6. * Sends php variables to Firebugs console.log or just sets javascript variable
  7. * Console method requires Firebug at client browser. You can download it at http://www.getfirebug.com
  8. *
  9. * @author Vladimir Luchaninov
  10. * @version 1.0 (16 Oct 2007)
  11. */
  12.  
  13. class JsDebugHelper extends Helper {
  14.  
  15.     var $varPrefix = 'JsDebug_';
  16.     var $varCounter = 1;
  17.  
  18.     /**
  19.      * Makes Firebug console.log of $value
  20.      *
  21.      * @param variant $value
  22.      * @param string $type
  23.      *     You may specify icon near the debug message. Possible values: info, warn, error
  24.      * @return string
  25.      */
  26.     function console($value, $type=null) {
  27.         if (empty($type) || !in_array($type, array('info', 'warn', 'error'))) {
  28.             $type = 'log';
  29.         }
  30.  
  31.         return $this->output($this->_wrapScript('console.'.$type.'('.$this->_wrapEval($value).')'));
  32.     }
  33.  
  34.     function info($value) {
  35.         return $this->console($value, 'info');
  36.     }
  37.  
  38.     function warn($value) {
  39.         return $this->console($value, 'warn');
  40.     }
  41.  
  42.     function error($value) {
  43.         return $this->console($value, 'error');
  44.     }
  45.  
  46.     /**
  47.      * Alerts variable dump
  48.      *
  49.      * @param variant $value
  50.      * @return string
  51.      */
  52.     function alert($value) {
  53.         ob_start();
  54.         print_r($value);
  55.         $value = ob_get_clean();
  56.  
  57.         return $this->output($this->_wrapScript('alert(\''.$this->_escapeString($value).'\')'));
  58.     }
  59.  
  60.     /**
  61.      * Sets javascript variable
  62.      *
  63.      * @param variant $value
  64.      * @param string $name
  65.      *     If empty then name will be generated as JsDebug_1, JsDebug_2, ...
  66.      * @return string
  67.      */
  68.     function set($value, $name=null) {
  69.         if (empty($name)) {
  70.             $name = $this->varPrefix . $this->varCounter++;
  71.         }
  72.  
  73.         return $this->output($this->_wrapScript('var '.$name.' = '.$this->_wrapEval($value)));
  74.     }
  75.  
  76.     /**
  77.      * Very similar to Javascript Helper escapeString
  78.      * But this version also includes replacement of </script>
  79.      *
  80.      * @param string $string
  81.      * @return string
  82.      */
  83.     function _escapeString($string) {
  84.         $escape = array(
  85.             "\r\n" => '\n',
  86.             "\r" => '\n',
  87.             "\n" => '\n',
  88.             '"' => '\"',
  89.             "'" => "\\'",
  90.             '</script>' => '<\/script>'
  91.         );
  92.         return r(array_keys($escape), array_values($escape), $string);
  93.     }
  94.  
  95.     function _wrapScript($s) {
  96.         return '<script type="text/javascript">'.$s.'</script>';
  97.     }
  98.  
  99.     function _wrapEval($value) {
  100.         return 'eval('.json_encode($value).')';
  101.     }
  102.  
  103. }
  104.  
  105. ?>

]]> http://php.southpark.com.ua/2007/vyvod-iz-php-v-firebug-helper-dlya-cakephp/feed/ 8