Moshtaghi.ir » php

کتاب مرجع برای سیمفونی

مهدی — Fri, 24 Jul 2009 22:04:55 +0000

اگر خواننده ثابت وبلاگ من باشید به احتمال زیاد می‌دانید که Symfony یک فریم‌ورک قدرتمند برای توسعه وب است. فریم‌ورکی که به نظر من سختی کار را تا حدی کم می‌کند که طراحی اولیه جداول برنامه مشکل‌ترین و وقت‌گیر ترین قسمت توسعه برنامه می شود. (که آن هم به برکت Eclipse و پلاگین‌هایش و فرمت YAML تا حد زیادی راحت شده است)

برای انجام دادن توسعه با این فریم‌ورک سخت‌ترین قسمت، یادگیری آن است که باز هم به برکت سایت رسمی پروژه بسیار راحت شده زیرا راه‌های مختلفی همچون خود آموز‌ها، فیلم‌ها و کتاب‌های زیادی را آماده کرده‌اند که در اینجا می‌توانید ببینید. بنده هم چند وقتی است که علاقمند به یادگیری این فریم‌ورک شده‌ام و تا جایی که توانسته‌ام خودآموز Jobeet را ترجمه کرده‌ام و انشالله این کار را ادامه خواهم داد.

نکته اصلی اینجاست که برای شروع این خودآموز‌ها بسیار خوب هستند ولی وقتی که می‌خواهیم پروژه خودمان را انجام دهیم به مشکل بر می‌خوریم. زیرا احتمالاْ سوالاتی پیش می‌آید که جواب آنها در این خود‌آموز‌ها نیست و یا حدالقل بصورت واضح وجود ندارد.

اینجاست که جای خالی یک کتاب مرجع برای سیمفونی و پیکره‌بندی‌های آن حس می‌شود که باز هم سایت رسمی اینکار را انجام داده است و کتابی را تحت عنوان «کتاب مرجع سیمفونی» که به لاتین «The symfony Reference Book» می‌شود منتشر کرده است.

عنوان بخش‌های این کتاب عبارتند از:

همچنین می‌تونید نسخه PDF این کتاب رو با حجم نا قابل 1.2Mb از اینجا دریافت کنید.

استفاده از وردپرس به عنوان یک فریم‌ورک PHP

مهدی — Thu, 23 Jul 2009 20:52:41 +0000

وردپرس یک راه حل عالی برای راه اندازی وبلاگ است که از پس هر کاری بر می‌آید. قدرت باور نکردنی این پلتفرم امکان توسعه یک وبسایت شخصی را در کمترین زمان و کمترین زحمت ایجاد می‌کند. (نکته‌ای بسیار مهم در طراحی و توسعه وب)
در این مقاله می‌بینید که چگونه بوسیله ورد‌پرس، وبسایتی حرفه ای ایجاد کنید. تنها کافی است تا کمی HTML بدانید، در این صورت به ادامه مطلب توجه کنید.

تمامی پلتفرم در یک صفحه PHP

برای شروع اینکار ملزوماتی نیاز است همچون وردپرس نصب شده، کمی اطلاعات راجع به HTML که خیلی بهتر می‌شود اگر راجع به PHP هم بدانید و یک ادیتور HTML تا کدها را در آن ویرایش کنید. (برای این منظور Eclipse گزینه فوق‌العاده‌ای می باشد که قبلا مورد بحث بوده است) اما یک ادیتور ساده هم نیاز ما را رفع می‌کند.
وردپرس روی صفحات PHP کار می‌کند، اما شمایی که اطلاعاتی راجع به PHP ندارید نگران نباشید زیرا برای هدف ما همان HTML کافی است.

فایلی با نام test.php ایجاد کنید و آن را در پوشه ریشه وبلاگ خود قرار دهید. (همان پوشه‌ای که فایل‌هایی از قبیل wp-config.php، wp-ligin.php و یا … در آن قرار دارند)
حالا قطعه کد زیر را در خط اول فایل خود کپی کنید

 include(’wp-blog-header.php’); ?>

با همین قطعه کد ساده تمامی ویژگی‌ها، دستورات و توابع وردپرس را در این صفحه فعال می‌سازید! برای آزمایش آن می‌توانید کدهای زیر را به فایل خود اضافه کنید.

 include(’wp-blog-header.php’); ?>


 bloginfo(’name’); ?>
 bloginfo(’description’); ?>

سپس فایل را ذخیره کرده و آن را در مرورگر خود مشاهده کنید. برای مثال اگر آدرس وب‌سایت شما http://moshtaghi.ir باشد، می‌توانید صفحه مذکور را در آدرس http://moshtaghi.ir/test.php مشاهده کنید.
در این صفحه شما می‌توانید نام و توضیحات مربوط به وب‌سایت خود را که از پایگاه داده استخراج شده‌اند را مشاهده کنید.

نوشتن یک صفحه وب کامل در ۱۰ ثانیه

اینکه صفحات ایجاد شده به این روش از نظر ظاهری با قالب اصلی وب‌سایت سازگاری داشته باشند خیلی مهم است، اما پیاده سازی قالب فعلی وب‌سایت در قالب HTML کار راحتی نیست و البته قرار هم نیست تا آن را دوباره ایجاد کنیم!
برای اینکار تنها کافیست تا کد زیر را در صفحه مورد نظر کپی کرده و ذخیره کنیم.

 include(’wp-blog-header.php’); ?>
 get_header(); ?>

…

 get_footer(); ?>

در این صفحه با استفاده از توابع get_header و get_footer می‌توانید هیدر و فوتر وب‌سایت (قالب فعلی) خود را بکار بگیرید، پس تنها کافیست تا محتوای اصلی صفحه را ایجاد کرده و فایل را ذخیره کنید.
حتی می‌توانید ساید‌بار فعلی قالب را هم به این صورت و با استفاده از تابع get_sidebar بکار بگیرید.

 include(’wp-blog-header.php’); ?>
 get_header(); ?>

…

 get_sidebar(); ?>
 get_footer(); ?>

اگر راجع به توابع وردپرس نمی‌دونید و یا دوست دارید بیشتر بدونید به این آدرس و این آدرس مراجعه کنید که اولی وبلاگ گناهکار عزیز و بعدی هم داکیومنشن‌های اصلی وردپرس می‌باشند.
کار خیلی راحت بود ولی سوالی شاید برای بعضی‌ها پیش آمده باشد که:

چرا و چه هنگام باید برای ایجاد صفحه وب از وردپرس استفاده کنیم؟

برخی موارد را می‌توان بوسیله یک تابع وردپرس و یا یک افزونه در صفحه‌ای بکار برد، بنابراین هنگامی که شما فایل wp-blog-header.php را در صفحه خود include می‌کنید، می‌توانید از وردپرس به عنوان یک فریم‌ورک عالی برای توسعه وب‌سایت خود استفاده کنید.
سوالی که پیش می‌آید این است که «چرا از برگه‌های ساده وردپرس بهمراه قالبی خاص استفاده نکنیم؟»
بله، می‌توان اینکار را کرد و البته در برخی موارد بهترین راه حل است. اما بزرگترین مزیت این سیستم، داشتن کنترل کامل بروی صفحه است. می‌توانید تنها افزونه‌، اسکریپتی خاص و یا هر آنچه به ذهنتان می‌رسد را نمایش دهید. می‌شود به کل سایدبار را حذف کرد و یا جای ان را تغییر داد و … . می شود اینها را با استفاده از برگه‌های وردپرس هم انجام داد اما باید سختی‌ها و پیچیدگی‌های زیادی را متحمل شد.

چه کارهایی را می‌توان با این تکنیک انجام داد؟

هر کاری که بخواهید را می‌توانید با این شیوه انجام دهید، اما معمول‌ترین و عقلانی‌ترین آنها عبارتند از:

هنگامی که وبلاگی دارید و می‌خواهید وب‌سایتی را کنار ان داشته باشید و به آن بسط دهید.
هنگامی که از یک قالب وردپرسی خوشتان آمده باشد و بخواهید برای وب‌سایت خود از آن استفاده کنید.
هنگامی که بخواهید تبلیغی را برای نتایج جستجو روی یک صفحه خود اعمال کنید.
هنگامی که بخواهید یک Application کوچک را در کنار وبلاگ خود اضافه کنید.

و در نهایت به شما پیشنهاد می‌کنم حتماْ از این ویژگی عالی که وردپرس برای ما به ارمغان اورده است استفاده کنید تا قدرت سرشار فریم‌ورکی همچون ورد‌پرس را شاهد باشید و اگر ایده‌ای خاص در زمینه کاربرد این شیوه دارید حتماْ با من در میان بگذارید. ممنون می‌شم.

منبع این مطلب اینجاس

پ‌ن: امروزه طراحی و توسعه وب بازار مناسب و تقریباْ دست نخورده‌ای دارد که هر کس می‌تواند به آن وارد شود، اما لازمه آن سرعت بالا در یادگیری و اجرا می‌باشد. با سرعت بالا در یادگیری کاری ندارم اما تنها راه رسیدن به سرعت بالا در اجرا و پیاده‌سازی استفاده از فریم‌ورک‌ها می‌باشد. حال این فریم‌ورک به سادگی WP باشد یا به عظمت Symfony، چه فریم‌ورکی برای PHP باشد، یا فریم‌ورکی برای JS و یا حتی CSS.

سیمفونی فینالیست شد

مهدی — Tue, 23 Jun 2009 12:47:30 +0000

چند هفته پیش در سایت Sourceforge حرکتی مبنی بر انتخاب بهترین پروژه‌های کدباز در رده‌های مختلف به راه افتاد. توسعه دهندگان و کاربران زیادی در این انتخاب (شاید هم رقابت انتخاباتی!!!) شرکت کردند، سیمفونی نیز یکی از این پروژه‌های کدباز بود که با پشتیبانی و کمک کاربرانش توانست در ۳ گروه فینالیست باشد که این گروه‌ها عبارتند از:

بهترین پروژه!
بهترین ابزار یا برنامه برای توسعه دهندگان
بهترین پروژه برای کسب و کار

شما هم می‌توانید برای کمک، در سایت Sourceforge به سیمفونی رای دهید و سپس با نوشتن مطالبی مرتبط با سیمفونی در وبلاگ خود، توییتر و یا هرجایی که خودتان می‌دانید در معرفی و گسترش این فریم‌ورک قدرتمند سهیم باشید. (حدالقل این را دوباره توییت کنید، تو رو خدا!!!)

این مطلب در وبلاگ سیمفونی

آموزش سیمفونی روز ششم – مطالب بیشتری از لایه مدل

مهدی — Mon, 15 Jun 2009 11:30:06 +0000

دیروز روز مهمی بود. یاد گرفتیم که چگونه URLهای زیاد بسازیم و اینکه چگونه از سیمفونی برای خودکار سازی موارد زیادی استفاده کنیم. امروز با پیچیده کردن کد‌ها، قابلیت‌های بهتری به jobeet اضافه می‌کنیم. شما در طول این فرایند، اطلاعات بیشتری راجع به تمامی ویژگی‌هایی که در روز پنجم به آن اشاره شد دریافت می‌کنید.

ضوابط شیء Propel

با توجه به قوانین روز دوم:
« هنگامی که کاربری به سایت وارد می‌شود، لیستی از مشاغل فعال را مشاهده می‌کند»
اما در حال حاضر تمامی مشاغل لیست می‌شوند، چه فعال باشند و چه …

// apps/frontend/modules/job/actions/actions.class.php
class jobActions extends sfActions
{
  public function executeIndex(sfWebRequest $request)
  {
    $this->jobeet_job_list = JobeetJobPeer::doSelect(new Criteria());
  }
 
  // ...
}

یک شغل فعال نباید بیشتر از ۳۰ روز پیش پست شده باشد. متد doSelect یک شیء Criteria را می‌گیرد که همان شرح در‌خواست پایگاه داده برای اجرا است.
در کد بالا، متد Criteria بصورت خالی عبور داده شده، که به معنی برگشت دادن تمامی رکورد‌های موجود در جدول می‌باشد.
حالا آن را طوری تغییر می‌دهیم که تنها مشاغل فعال را برگرداند:

public function executeIndex(sfWebRequest $request)
{
  $criteria = new Criteria();
  $criteria->add(JobeetJobPeer::CREATED_AT, time() - 86400 * 30, Criteria::GREATER_THAN);
 
  $this->jobeet_job_list = JobeetJobPeer::doSelect($criteria);
}

متد Criteria::add یک شرط Where را به SQL ساخته شده اضافه می‌کند. در اینجا Criteria را برای تنها بازگرداندن مشاغل فعال محدود کردیم. متد add عملگر‌های مقایسه زیادی را پشتیبانی می‌کند، که پرکاربرد‌ترین آنها را مشاهده می‌کنید:

Criteria::EQUAL
Criteria::NOT_EQUAL
Criteria::GREATER_THAN, Criteria::GREATER_EQUAL
Criteria::LESS_THAN, Criteria::LESS_EQUAL
Criteria::LIKE, Criteria::NOT_LIKE
Criteria::CUSTOM
Criteria::IN, Criteria::NOT_IN
Criteria::ISNULL, Criteria::ISNOTNULL
Criteria::CURRENT_DATE, Criteria::CURRENT_TIME, Criteria::CURRENT_TIMESTAMP

اشکال‌زدایی SQLهای ایجاد شده توسط propel

با توجه به اینکه شما کدهای SQL را بطور دستی ایجاد نمی‌کنید، propel آنها را با توجه به موتور پایگاه داده‌ای که در روز سوم معرفی کردید ایجاد می‌کند. اما بعضی اوقات، مشاهده کدهای SQL ایجاد شده توسط propel می‌تواند بسیار سودمند باشد. برای مثال جهت اشکال‌زدایی یک query که به درستی کار نمی‌کند. در محیط dev سیمفونی این queryها را ثبت می‌کند (به همراه بسیاری از موارد دیگر). برای هر مجموعه از application و محیط یک فایل log وجود دارد. محتوای فایل frontend_dev.log را مشاهده کنید:

# log/frontend_dev.log
Dec 6 15:47:12 symfony [debug] {sfPropelLogger} exec: SET NAMES 'utf8'
Dec 6 15:47:12 symfony [debug] {sfPropelLogger} prepare: SELECT jobeet_job.ID, jobeet_job.CATEGORY_ID, jobeet_job.TYPE, jobeet_job.COMPANY, jobeet_job.LOGO, jobeet_job.URL, jobeet_job.POSITION, jobeet_job.LOCATION, jobeet_job.DESCRIPTION, jobeet_job.HOW_TO_APPLY, jobeet_job.TOKEN, jobeet_job.IS_PUBLIC, jobeet_job.CREATED_AT, jobeet_job.UPDATED_AT FROM `jobeet_job` WHERE jobeet_job.CREATED_AT>:p1
Dec 6 15:47:12 symfony [debug] {sfPropelLogger} Binding '2008-11-06 15:47:12' at position :p1 w/ PDO type PDO::PARAM_STR

اینجا می‌توانید SQL ایجاد شده خودتان توسط propel را که به همراه شرطی که بروی ستون created_at اعمال می‌شود مشاهدی کنید. (WHERE jobeet_job.CREATED_AT > :p1)

یادداشت: رشته p1 در query نشان دهنده شرح بیان شده SQL ایجاد شده توسط propel است. مقدار واقعی p1 (در مثال بالا «2008-11-06 15:47:12» ) در هنگام اجرای query ثبت می‌شود و بطور صحیح بوسیله موتور پایگاه داده گریز داده می‌شود. استفاده از این عبارات آماده شده، قابل نمایش بودن را برای حملات SQL injection کم می‌کند.

این عالیست، اما سوئیچ کردن بین مرورگرها، IDEها و فایل‌های log کمی آزار دهنده است. اینگونه باید بصورت مداوم یک تغییر را آزمایش کنید. از نوار ابزار اشکال‌زدایی symfony ممنونیم، تمام اطلاعاتی که نیاز دارید براحتی در مرورگر در دسترس می‌باشد.

ترتیب شیء

کد بالا به هنگام کار کردن، نتیجه بعیدی از چیزی که در روز دوم تعریف کردیم را می‌دهد:
«یک کاربر می‌تواند برگردد و دوباره شغل خود را فعال کند و زمان انقضای آن را از ۳۰ روز بیشتر کند …»
اما ایم کد تنها به مقدار موجود در فیلد created_at تکیه می‌کند، و چون این ستون تنها زمان ایجاد رکورد را ثبت می‌کند نمی‌توانیم این قابلیت را بر مبنای آن پیاده کنیم.
اما اگر نمای پایگاه داده‌ای که در روز سوم ایجاد کردیم را بخاطر بیاورید، یک ستون به نام expires_at نیز مشخص شده بود. و مقدار پیشفرض برای آن در اطلاعات پایه در نظر گرفته نشد. این ستون می‌تواند بصورت خودکار مقدار ۳۰ روز پس از تاریخ ثبت را بگیرد.
هنگامی که نیاز است تا برخی مقادیر بصورت خودکار و مرتب بر مبنای پایگاه داده، قبل از یک شیء ایجاد شوند، می‌توانید متد save از کلاس مدل را مهم‌تر کنید.

// lib/model/JobeetJob.php
class JobeetJob extends BaseJobeetJob
{
  public function save(PropelPDO $con = null)
  {
    if ($this->isNew() && !$this->getExpiresAt())
    {
      $now = $this->getCreatedAt() ? $this->getCreatedAt('U') : time();
      $this->setExpiresAt($now + 86400 * 30);
    }
 
    return parent::save($con);
  }
 
  // ...
}

متد isnew هنگامی که شیء هنوز در پایگاه داده مرتب سازی نشده، مقدار true و در غیر این صورت false را بر می‌گرداند.
حالا اکشن را طوری تغییر می‌دهیم تا بجای created_at از فیلد expires_at استفاده کند:

public function executeIndex(sfWebRequest $request)
{
  $criteria = new Criteria();
  $criteria->add(JobeetJobPeer::EXPIRES_AT, time(), Criteria::GREATER_THAN);
 
  $this->jobeet_job_list = JobeetJobPeer::doSelect($criteria);
}

به این صورت، query را برای انتخاب بر حسب ویژگی expires_at محدود کردیم.

اطلاعات بیشتر راجع داده‌های اولیه

Refresh کردن صفحه اصلی، تغییری در پی ندارد. زیرا این مشاغل همین چند روز پیش پست شده‌اند. این تغییرات را ایجاد کنید تا مشاغلی که expires شده‌اند را به جدول بیفزائید:

# data/fixtures/020_jobs.yml
JobeetJob:
  # other jobs
 
  expired_job:
    category_id:  programming
    company:      Sensio Labs
    position:     Web Developer
    location:     Paris, France
    description:  |
      Lorem ipsum dolor sit amet, consectetur
      adipisicing elit.
    how_to_apply: Send your resume to lorem.ipsum [at] dolor.sit
    is_public:    true
    is_activated: true
    expires_at:   2005-12-01
    token:        job_expired
    email:        job@example.com

یادداشت: کد‌ها را به دقت کپی کنید تا فرورفتگی‌ها از بین نرود. expires_job تنها دو تا Space قبل از خود دارد.

همانطور که شغل اصافه شده را در فایل fixture می‌بینید، مقدار ستون created_at مشخص شده است. حتی اگر بطور خودکار توسط propel پر شود.
مقدار مشخص شده بر هر مقدار پیشفرضی اولویت دارد. Fixture را دوباره بارگذاری کنید و صفحه را refresh کنید:

$ php symfony propel:data-load

می‌توانید query زیر را برای مطمئن شدن از اینکه ستون expires_at بطور پیشفرض توسز متد save و بر مبنای ستون created_at مقدار دهی می‌شوند را اجرا کنید:

SELECT `position`, `created_at`, `expires_at` FROM `jobeet_job`;

پیکره‌بندی دستی

در متد JobeetJob::save بوسیله کدهای پیچیده‌ای تعداد روزهای فعال بودن را مشخص کردیم. اما خیلی بهتر است تا این مقدار را قابل پیکره‌بندی کنیم.
Symfony برای هر application یک فایل پیکره‌بندی ایجاد می‌کند تا ویژگی‌های خاص در آن تعریف شود. فایل app.yml می‌تواند شامل هر تنظیمی که شمما می‌خواهید باشد.

# apps/frontend/config/app.yml
all:
  active_days: 30

در application، این تنظیمات بوسیله کلاس سراسری sfConfig در دسترس هستند.

sfConfig::get('app_active_days')

تنظیمات بهمراه پیشوند app_ هستند، زیرا کلاس sfConfig علاوه بر این دسترسی به تنظیمات symfony را هم مهیا می‌کند، که در آینده می‌بینیم.
کدها را بروز می‌کنیم تا تنظیمات جدید اعمال شود.

public function save(PropelPDO $con = null)
{
  if ($this->isNew() && !$this->getExpiresAt())
  {
    $now = $this->getCreatedAt() ? $this->getCreatedAt('U') : time();
    $this->setExpiresAt($now + 86400 * sfConfig::get('app_active_days'));
  }
 
  return parent::save($con);
}

فایل پیکره‌بندی app.yml راه فوق‌العاده‌ای برای متمرکز کردن تنظیمات سراسری application شما می‌باشد.
در آخر، اگر نیاز به تعریف تنظیمات سراسری گسترده‌تری دارید، تنها یک فایل app.yml در پوشه config ریشه ایجاد کنید و …

دوباره سازی – Refactoring

اگر چه این کد کار مورد نظر را انجام می‌دهد، اما راه سریعی نیست. آیا می‌توانید مشکل آن را بیابید؟
کد Criteria متعلق به اکشن نیست (لایه کنترل) بلکه متعلق به لایه مدل است. در ساختار MVC، لایه مدل تمام منطق برنامه را مشخص می‌کند و لایه کنترل تنها لایه مدل را برای بازیافت داده‌ها فراخوانی می‌کند. از آنجایی که این کد مجموعه‌ای از مشاغل را بر می‌گرداند، آن را به کلاس JobeetJobPeer انتقال می‌دهیم و متدی بنام getActiveJobs ایجاد می‌کنیم:

// lib/model/JobeetJobPeer.php
class JobeetJobPeer extends BaseJobeetJobPeer
{
  static public function getActiveJobs()
  {
    $criteria = new Criteria();
    $criteria->add(self::EXPIRES_AT, time(), Criteria::GREATER_THAN);
 
    return self::doSelect($criteria);
  }
}

حالا کد اکشن می‌تواند از این متد برای بازیافت مشاغل استفاده کند.

public function executeIndex(sfWebRequest $request)
{
  $this->jobeet_job_list = JobeetJobPeer::getActiveJobs();
}

این دوباره سازی چندین مزیت نسبت به کد قبل داشت:

منظق دریافت مشاغل فعال حالا در لایه مدل قرار دارد، جایی که به آن متعلق است.
کد موجود در قسمت کنترل بسیار خوانا‌تر از قبل است.
متد getActiveJobs می‌تواند دوباره مورد استفاده قرار گیرد (برای مثال در سایر اکشن‌ها)
کد لایه مدل حالا یک واحد قابل آموزش است.

حالا مرتب سازی مشاغل را بر حسب ستون expired_at صورت می‌دهیم.

static public function getActiveJobs()
{
  $criteria = new Criteria();
  $criteria->add(self::EXPIRES_AT, time(), Criteria::GREATER_THAN);
  $criteria->addDescendingOrderByColumn(self::EXPIRES_AT);
 
  return self::doSelect($criteria);
}

متد addDescendingOrderByColumn یک شرط ORDER BY به SQL ایجاد شده اضافه می‌کند. (متد addAscendingOrderByColumn هم وجود دارد)

دسته‌ بندی‌های صفحه اصلی

طبق قوانین روز دوم:
«مشاغل بر حسب دسته‌بندی و سپس بر حسب تاریخ انتشارشان لیست می‌شود (ابتدا مشاغل جدید تر)»
تا حالا، دسته‌بندی شغل را در اشتراک نمی‌گرفتیم. مطابق قوانین، صفحه اصلی باید مشاغل را بر حسب دسته‌بندی‌ نمایش دهد. ابتدا باید تمام دسته‌بندی‌ها را با کمترین شغل فعال دریافت کنیم.
کلاس JobeetCategoryPeer را باز کنید و متد getWithJobs را به آن اضافه کنید:

// lib/model/JobeetCategoryPeer.php
class JobeetCategoryPeer extends BaseJobeetCategoryPeer
{
  static public function getWithJobs()
  {
    $criteria = new Criteria();
    $criteria->addJoin(self::ID, JobeetJobPeer::CATEGORY_ID);
    $criteria->add(JobeetJobPeer::EXPIRES_AT, time(), Criteria::GREATER_THAN);
    $criteria->setDistinct();
 
    return self::doSelect($criteria);
  }
}

متد Criteria::addJoin یک شرط JOIN را به SQL اضافه می‌کند. بصورت پیشفرض شرط JOIN به یک شرط WHERE اضافه می‌شود. در ضمن شما می‌توانید عملوند JOIN را با اضافه کردن ۳ آرگومنت زیر تغییر دهید.
(Criteria::LEFT_JOIN ، Criteria::RIGHT_JOIN و Criteria::INNER_JOIN)
بنابراین اکشن index را تغییر می‌دهیم:

// apps/frontend/modules/job/actions/actions.class.php
public function executeIndex(sfWebRequest $request)
{
  $this->categories = JobeetCategoryPeer::getWithJobs();
}

در قالب، احتیاج داریم تا حلقه‌ای برای مرور همه دسته‌بندی‌ها و حلقه‌ای برای مرور مشاغل فعال داخل آنها داشته باشیم:

// apps/frontend/modules/job/indexSuccess.php
 use_stylesheet('jobs.css') ?>
 

   foreach ($categories as $category): ?>
     echo Jobeet::slugify($category->getName()) ?>">
      
        
          Feed
        
         echo $category ?>
      
 
       foreach ($category->getActiveJobs() as $i => $job): ?>
          echofmod($i,2) ? 'even':'odd'?>">
             endforeach; ?>
      
              
               echo $job->getLocation() ?>
            
            
               echo link_to($job->getPosition(), 'job_show_user', $job) ?>
            
            
               echo $job->getCompany() ?>
            
          
        
    
   endforeach; ?>

یادداشت: برای نمایش نام دسته‌بندی در قالب از echo استفاده کردیم. جالب نیست؟ $category یک شیء است و ما بطور خارق‌العاده‌ای آن را echo می‌کنیم! جواب این سوال در طول روز سوم بیان شد، هنگامی که متد __toString را برای تمامی کلاس‌های مدل تعریف کردیم.

برای اینکار باید متد getActiveJobs را به کلاس JobeetCategory اضافه کنیم. تا مشاغل فعال را از شیء دسته‌بندی باز گرداند.

// lib/model/JobeetCategory.php
public function getActiveJobs()
{
  $criteria = new Criteria();
  $criteria->add(JobeetJobPeer::CATEGORY_ID, $this->getId());
 
  return JobeetJobPeer::getActiveJobs($criteria);
}

در فراخوانی add، آرگومنت سوم را از قلم انداختیم زیرا Criteria::EQUAL مقدار پیشفرض است.
متد JobeetCategory::getActiveJobs برای برگرداندن مشاغل فعال از دسته بندی انتخابی از متد JobeetJobPeer::getActiveJobs استفاده می‌کند.
هنگامی که شما JobeetJobPeer::getActiveJobs را فراخوانی می‌کنید، محدودیتی برای هموار کردن بوسیله یک دسته‌بندی ایجاد می‌کنیم. در عوض عبور شیء دسته بندی، قطعاْ یک شیء Criteria را عبور می‌دهیم. چون این بهترین راه برای کپسوله کردن یک شرط است.
GetActiveJobs نیاز دارد تا آرگومنت Criteria را با ضوابط (criiteria) خود یکی کند. چون Criteria یک شیء است، کار کاملاْ راحتی است.

// lib/model/JobeetJobPeer.php
static public function getActiveJobs(Criteria $criteria = null)
{
  if (is_null($criteria))
  {
    $criteria = new Criteria();
  }
 
  $criteria->add(JobeetJobPeer::EXPIRES_AT, time(), Criteria::GREATER_THAN);
  $criteria->addDescendingOrderByColumn(self::EXPIRES_AT);
 
  return self::doSelect($criteria);
}

حدود نتایج

هنوز هم قوانینی برای اعمال شدن به لیست مشاغل صفحه اصلی وجود دارد:
«برای هر دسته بندی، تنها ۱۰ لینک می‌توانند در لیست نمایش داده شوند و یک پیوند امکان لیست شدن تمام مشاغل در یک دسته بندی را ایجاد می‌کند»
اینکار بوسیله استفاده از متد getActiveJobs راحت می‌شود.

// lib/model/JobeetCategory.php
public function getActiveJobs($max = 10)
{
  $criteria = new Criteria();
  $criteria->add(JobeetJobPeer::CATEGORY_ID, $this->getId());
  $criteria->setLimit($max);
 
  return JobeetJobPeer::getActiveJobs($criteria);
}

اختصاص دادن شرط LIMIT در مدل کار سختی است، اما بهتر است تا این مقدار قابلیت پیکره‌بندی داشته باشد. تغییراتی را در قالب ایجاد می‌کنیم تا نهایت مقدار نمایش مشاغل را از فایل app.yml بخواند.


 foreach ($category->getActiveJobs(sfConfig::get('app_max_jobs_on_homepage')) as $i => $job): ?>

و این تنظیمات را در فایل app.yml اضافه کنید:

all:
  active_days:          30
  max_jobs_on_homepage: 10

داد‌های اولیه پویا

برای اینکه نتایج تغییرات را مشاهده کنید، باید گروهی از داده‌های اولیه را وارد سیستم کنیم. می‌توان اطلاعات موجود در fixture را کپی کرد که شاید وقت‌گیر و کسل کننده باشد. Symfony اینکار را هم آسان کرده است. شما می‌توانید از کد‌های php در فایل‌های yml استفاده کنید. فایل 020_jobs.yml را باز کرده و کد‌های زیر را در انتهای آن اضافه کنید:

JobeetJob:
# Starts at the beginning of the line (no whitespace before)
 for ($i = 100; $i <= 130; $i++): ?>
  job_ echo $i ?>:
    category_id:  programming
    company:      Company  echo $i."\n" ?>
    position:     Web Developer
    location:     Paris, France
    description:  Lorem ipsum dolor sit amet, consectetur adipisicing elit.
    how_to_apply: |
      Send your resume to lorem.ipsum [at] company_ echo $i ?>.sit
    is_public:    true
    is_activated: true
    token:        job_ echo $i."\n" ?>
    email:        job@example.com
 
 endfor; ?>

دقت کنید که دندانه‌ها و فرورفتگی‌ها را رعایت کنید زیرا در غیر این صورت پردازش نمی‌شوند.
این نکات را همیشه بخاطر بسپارید:

عبارت همیشه باید در ابتدای خط و یا درون یک مقدار جاگذاری شده باشد.
اگر یک عبارت سطر را تمام کند، باید در خروجی مقدار «\n» را ذکر کنیم.

و می‌بینیم که در صفحه اصلی تنها ۱۰ شغل آخر اضافه شده است.

ایمن کردن صفحه شغل

هنگامی که شغلی به انقضاء می‌رسد، حتی اگر شما url آن را بدانید نباید به آن دسترسی پیدا کنید. سعی کنید تا URL یک شغل تاریخ گذشته را پیدا کنید. (id را با یک id واقعی در پایگاه داده عوض کنید)

SELECT id, token FROM jobeet_job WHERE expires_at < NOW()

/frontend_dev.php/job/sensio-labs/paris-france/ID/web-developer-expired

بجای نمایش شغل باید به صفحه ۴۰۴ منتقل شویم. اما چگونه می‌توان بصورت خودکار و بوسیله مسیر‌ها به این نتیجه رسید؟
بطور پیشفرض sfPropelRoute از متد استاندارد doSelectOne برای بازگداندن اشیاء استفاده می‌کند، و ما می‌توانیم مشروط بر اینکه خصیصه method_for_criteria در پیکره‌بندی مسیر باشد آن را تغییر دهیم:

# apps/frontend/config/routing.yml
job_show_user:
  url:     /job/:company_slug/:location_slug/:id/:position_slug
  class:   sfPropelRoute
  options:
    model: JobeetJob
    type:  object
    method_for_criteria: doSelectActive
  param:   { module: job, action: show }
  requirements:
    id: \d+
    sf_method: [GET]

متد doSelectActive یک شیء Criteria را که بوسیله مسیر ساخته شده را دریافت می‌کند:

// lib/model/JobeetJobPeer.php
class JobeetJobPeer extends BaseJobeetJobPeer
{
  static public function doSelectActive(Criteria $criteria)
  {
    $criteria->add(JobeetJobPeer::EXPIRES_AT, time(), Criteria::GREATER_THAN);
 
    return self::doSelectOne($criteria);
  }
 
  // ...
}

حالا، اگر سعی کنید تا شغل تاریخ گذشته‌ای را ببینید با صفحه ۴۰۴ مواجه می‌شوید.

پیوند به صفحه مشاغل

حالا، یک پیوند برای صفحه دسته‌بندی اضافه کرده و این صفحه را ایجاد می‌کنیم. اما صبر کنید! وقت امروز تمام شده و زمان کافی برای ادامه این بحث را نداریم. البته اگر شما زمان کافی را داشته باشید، اطلاعات لازم برای اینکار را هم دارید. سعی کنید تا اینکار را انجام دهید و یا فردا بهمراه یکدیگر انجامش دهیم.

فردا همدیگر را می‌بینیم

روی jobeet خود کار کنید، سعی کنید نهایت استفاده از مستندات API و مستندات آزاد موجود در سایت symfony را ببرید. فردا دوباره همدیگر را می‌بینیم و به ادامه کار می‌پردازیم.
موفق باشید…

انتخاب یک IDE مناسب php و سازگاری آن با symfony (قسمت اول)

مهدی — Mon, 08 Jun 2009 11:57:02 +0000

اگر به پست‌های قبلی که راجع به توسعه وب توسط php و البته فریم‌ورک بسیار قدرتمند symfony بود علاقه‌ای داشته باشید و آنها رو دنبال کنید، صد در صد برای ویرایش کد‌ها از یک ادیتور همچون gedit، kedit و یا شاید notepad استفاده کرده باشید. و در اینصورت متوجه شدید که دیگر نمی‌توان کار با سیمفونی رو روی این قبیل ویرایشگرها ادامه داد.
اینجاست که واجب می‌شود تا برای ادامه کار از یک IDE خوب استفاده کنید. البته انتخاب IDE مناسب کار راحتی نیست و البته در عین حال راحته!!! یعنی دامنه انتخاب زیاده و شما باید برای انتخاب بهترین IDE، این دامنه رو کوچک‌تر کنید.
برای کوچک کردن این دامنه باید توقع خود را از IDE بالا ببرید. در ادامه مطلب به بررسی این توقعات می‌پردازیم.

رنگ‌بندی کدها – Syntax highlighting

رنگ‌بندی درست کد‌ها خوانایی آن را تا حد بسیاری بالا می‌برد. البته این ویژگی روی تمامی IDEها و حتی editor‌ها وجود داره. (جز Notepad ویندوز که بدرد یادداشت نوشتن هم نمی‌خوره!!!)

اتمام خودکار کد – Code completion

این ویژگی به سرعت کد‌نویسی خیلی کمک می‌کنه، همونطور که خیلی‌ها می‌دونند مثلاْ برای نوشتن قطعه کد مربوط به مقصد یک لینک تنها حرف h را تایپ می‌کنید و IDE مقادیر href=”" و hreflang=”" رو به شما پیشنهاد می‌کنه.
البته این ویژگی روی کد‌های php هم به همین صورتی که در تصویر زیر مشاهد می‌کنید اعمال می‌شود.

پس تا اینجا تمام ادیتور‌ها از دامنه بزرگی که مورد بحث بود حذف شدن. (قابل توجه افرادی که گیر دادن به gedit و Kedit و emEditor و Notepad++ و همین قسم ویرایشگر‌ها)

ناوبری – Navigation

خیلی اوقات پیش می‌آید که شما داخل کد‌ها گم می‌شوید (مخصوصاْ به هنگام توسعه برنامه‌های نوشته شده در گذشته و یا کار‌های گروهی) و نیاز دارید تا برنامه شما رو به محل مورد نظر هدایت کنه. برای اینکار می‌توانید از امکان search یا Find که توی هر ویرایشگری پیدا می‌شه استفاده کنید. اما اگر پروژه کمی بزرگ باشد، دچار مشکل می‌شوید و آن زمان است که به امکانات بیشتری برای جستجو و ناوبری احتیاج پیدا می‌کنید. امکاناتی از قبیل Goto که می‌تونه شما رو به سطر، متد و یا کلاس خاصی هدایت کند (بر حسب کلمه کلیدی و یا تعریف از قبل). و یا پنلی که فایل شما را بر حسب کلاس‌ها و توابع موجود در آن بخش بندی و لیست می‌کند و …
راستش این قسمت خیلی قابل توضیح دادن نیست و به قول معروف : حلوای تن تنانی، تا نخوری ندانی!!!

نمایش خطا‌ها و اخطارها

اشتباهات نحوی syntax و یا حتی غلط‌های املایی برنامه‌نویسی (منظورم از این واژه اختراعی اشتباهاتی همچون جا انداختن آکولاد و امثال این است) مشکلی است که به وفور پیش می‌آید. پس یک IDE خوب باید آنها را تشخیص داده و به شما اعلام کند و گیر خود را تا زمان تصحیح پابرجا نگه دارد.

دوباره سازی و سازندگی کد – Refactoring and code generation

این ویژگی، از آن ویژگی‌هایی است که به هیچ شکلی نمی‌شه از آن گذشت! بعضی اوقات پیش می‌آید که مجبور به دوباره نویسی و یا تغییر مکان کلاس‌ها، توابع و یا شاید فایل‌ها هستیم و اینکار در پروژه‌های کوچک هم کار راحتی به حساب نمی‌آید. چه برسد به …
سه امکان refactoring که بیشتر به کار می‌آید رو در زیر لیست کردم:

Move که تمام includeها و requireها را به هنگام انتقال فایلی از جایی به جای دیگر بروز می‌کند تا مشکلی در روند اجرای پروژه پیش نیاد.
Rename که این اطمینان را می‌دهد که از تغییر نام هر چیزی هیچ مشکلی برای پروژه پیش نخواهد آمد.
Safe delete که شما را مطمئن می‌کند که حذف یک فایل پروژه آسیبی به سایر قسمت‌ها وارد نمی‌کند.

علاوه بر این برخی IDEها امکان ایجاد کد‌های مربوط به ساخت توابع سازنده، گیرنده‌ها و … را نیز فراهم می‌کنند.

اشکال‌زدایی – Debugging

معمولاْ کد‌نویسان php برای اشکال‌زدایی کد‌ها از دستور echo و die استفاده می‌کنند. اما این شیوه هرگز جای اشکال‌زدایی خط‌به‌خط را برای برنامه‌نویس نمی‌تواند پر کند. مخصوصاْ در برنامه‌های بزرگ‌تر. یک IDE خوب این امکان را برای کدنویس مهیا می‌کند.

سیستم کنترل نسخه – Versioning system

این سیستم می‌تواند در هر دو شیوه توسعه فردی و گروهی مفید باشد. این ویژگی امکان مقایسه کد فعلی را با نسخه‌های پیشین بصورت تصویری ایجاد می‌کند. همچنین امکان کپی کردن تغییرات به سایر ورژن‌ها و برگشتن به وضعیت قبلی و ادغام تغییرات ایجاد شده توسط سایر اعضاء تیم را هم برای ما مهیا می‌کند.

هنگامی که شما تغییرات را چک کرده و آنها را اعمال نمودید، یکی کردن IDE با سیستم‌های کنترل نسخه‌ای همچون CVS، SVN و … بسیار بهتر از اجرای یک برنامه جدا برای کار با آنها می‌باشد.

خصوصیات سمت مشتری – Client-side features

کمتر پیش می‌آید تا کد‌های php بصورت جدا نوشته شوند و معمولاْ به همراه کد‌های HTML و همچنین CSS و java script می‌آیند. در نتیجه امکان Code complation برای این قسم کد‌ها در فایل‌های php می‌تواند بسیار سودمند و پرکاربرد باشد.

کدام IDE تمام این ویژگی‌ها را شامل می‌شود؟

همانطور که می‌دانید در دنیای متن‌باز برنامه‌های بسیار پر قدرت و مفیدی یافت می شوند. در زمینه IDEها هم می‌توان به جرات گفت که بهترین IDEها OpenSource هستند.
با اندکی دیکتاتوری و بدون هیچ توضیحی ۲ دسته را اینجا نام می‌بریم:

IDEهای مبتنی بر Eclipse

فکر می‌کنم پلتفرم Eclipse معرف حضور بیشتر دوستان باشد، افزونه‌های بسیاری نیز برای کار با php روی Eclipse وجود دارند که برخی از آنها عبارتند از: PDT، Zend Studio، Aptana PHP و همچنین Aptana Studio Pro .
نکته: Aptana را می‌توان بصورت مجزا از Eclipse هم نصب کرد

NetBeans

این IDE تقریباْ نو ظهور هم، بسیار مناسب می‌باشد و البته برای کار روی Eclipse ساخته نشده است. بیشتر ویژگی‌های سایر IDEها را دارد و خوشبختانه OpenSource هم می‌باشد. با توجه به توسعه سریع، روان و جالب آن آینده بسیار روشنی را پیش روی دارد.

نتیجه اخلاقی

آقای الکساندر ماکارو (Alexander Makarov) در مجله Smashing، بررسی جالبی بین این IDEها انجام دادند که به شما پیشنهاد می‌کنم حتماْ آن را از این آدرس مطالعه کنید.
بنده شخصاْ بعد از مشاهده این مقایسه و تست کردن دو افزونه Aptana و PDT به این نتیجه رسیدم که با همون PDT کار کنم. چون اگر حقیقت را بخواهید همین PDT هم کلی از سرم زیاده و خیلی امکانات دارد که هنوز نشناخته‌ام، اما فکر می‌کنم Aptana امکانات جانبی بیشتری نسبت به PDT دارد. امکانات و ویژگی‌های Zend Studio هم که غیر قابل انکار است، اما من پول ندارم. NetBeans هم مطمئناْ چیز خوبی است چون توی یکی از توییت‌های مرتضی الوانی خوندم که از اون استفاده می‌کنه.
در هر صورت انتخاب من، فعلاْ Eclipse و پلاگین PDT است و با آن راحتم. بهترین شیوه برای نصب آن هم استفاده از بسته PDT All In One است. با حجم تقریبی 140mb که بعد از Extract کردن آماده استفاده است. بروی کلیه پلتفرم‌های لینوکس ۳۲ و ۶۴، مکینتاش و ویندوز هم قابل اجرا می‌باشد. (از این آدرس می‌توانید نسخه مناسب با سیستم خود را دریافت کنید)

و اما ادامه ماجرا

تا کنون به نتیجه نسبتاْ خوبی برای قسمت اول عنوان این پست رسیدیم، یعنی IDE خود را برای کار با php انتخاب کردیم. اما برای کار با سیمفونی باید تا حدودی IDE را با خواسته‌های خود سازگار کنیم. اینکار را به بخش‌های مختلفی همچون symfony code completion در PDT، ایجاد رنگ‌بندی برای فایل‌های YAML و استفاده از پلاگین Subclipse برای کار با SVN تقسیم می‌کنیم که در قسمت دوم این مقاله به شرح آن خواهیم پرداخت.

بیشتر راجع به مقدمات Eclipse در الوان‌وب

پ‌ن : این نیمچه مقاله رو با الهام و ادقام این نوشته از مجله Smashing و مطلبی در ویکی symfony نوشتم.

آموزش سیمفونی روز پنجم – مسیر‌یابی

مهدی — Mon, 01 Jun 2009 17:19:19 +0000

اگر روز چهارم را تمام کرده باشید، باید به اصول MVC آشنا شده باشید. پس زمان بیشتری را صرف آن کنید و به گذشته فکر نکنید!
در تمرین دیروز، صفحات jobeet را گسترش دادیم، بنابراین چندین راه‌کار Symfony را بررسی کردیم. راه‌کارهایی همچون layout، کمک‌کننده‌ها و شیار‌ها.
امروز هم با دنیای شگفت انگیز مسیر‌یابی (Routing) در Symfony آشنا می‌شویم.

URLها

اگر در صفحه اصلی بروی شغلی کلیک کنید، URL آن همانند این است: job/show/if/1 . اگر پیش از این وبسایتی را با PHP توسعه داده باشید، احتمالاْ بیشتر با URLهایی از قبیل job.php?id=1 خو گرفته‌اید. Symfony چگونه اینکار را انجام داد؟ چگونه اکشن مبنا برای URL را تعیین می‌کند؟ امروز پاسخ تمام این سوالات را بررسی می‌کنیم.
اما ابتدا در رابطه با URLها صحبت می‌کنیم و اینکه آنها واقعاْ چه هستند. در مفاهیم وب، یک URL معرف یکتا برای وسیله‌ای در وب می‌باشد. هنگامی که به URL خاصی می‌روید، بوسیله همان URL از مرورگر برای واکشی وسیله‌ای معین سوال می‌کنید. بنابراین URL رابط میان وبسایت و کاربران است، که باید شامل اطلاعاتی از منبع خود باشد. اما URLهای مرسوم واقعاْ شرح درستی از محتوا نیستند، بلکه ساختار کلی برنامه را نمایش می‌دهند. کاربران به اینکه وبسایت شما بوسیله PHP توسعه داده‌شده و یا … کاری ندارند و از آن گذشته نشان دادن ساختار کاری برنامه به کاربران از لحاظ امنیتی کار اشتباهی می‌باشد. چرا که کاربران می‌توانند URL قسمت‌هایی که دسترسی محدود دارند را حدس بزنند. البته توسعه دهنده باید این صفحات را با شیوه مناسبی امن کند اما اینگونه شما می‌توانید بر امنیت آنها بیفزائید.
URLها در Symfony به اندازه‌ای اهمیت دارند که فریم‌ورکی مختص به مدیریت آنها وجود دارد: فریم‌ورک مسیر‌یابی(routing). مسیر یابی URIهای داخلی و URLهای خارجی را مدیریت می‌کند. هنگامی که درخواستی وارد می‌شود، مسیر‌یاب URL را تجزیه کرده و به یک URI داخلی تبدیل می‌کند.
شما قبلاْ URI داخلی صفحات job را در قالب showSuccess.php دیده‌اید:

'job/show?id='.$job->getId()

کمک‌کننده url_for() این URI داخلی را به یک URL صحیح تبدیل می‌کند:

/job/show/id/1

URIهای داخلی از چندین بخش تشکیل شده‌اند: job یک ماژول است، show یک اکشن است و رشته کوئری (query string) پارامتر‌هایی را برای اجرای اکشن اضافه می‌کند. طرح کلی برای URLها اینگونه است:

MODULE/ACTION?key=value&key_1=value_1&...

از آنجایی که Symfony دو راه برای پردازش دارد، می‌توانید URLها را بدون انجام کار تکنیکی تغییر دهید. این یکی از مزایای اصلی الگوی طراحی front-controller است.

پیکره‌بندی مسیر‌یابی

مسیر‌یابی بین URIها و URLها در فایل پیکره‌بندی routing.yml صورت می‌گیرد:

# apps/frontend/config/routing.yml
homepage:
  url:   /
  param: { module: default, action: index }
 
default_index:
  url:   /:module
  param: { action: index }
 
default:
  url:   /:module/:action/*

این فایل مسیر یابی را شرح می‌دهد. مسیر یک نام (homepage)، یک الگو (/:module/:action/*) و مقداری پارامتر دارد (کلید param). هنگامی که درخواستی وارد می‌شود، مسیر‌یاب سعی می‌کند تا URL را با یک الگو تطبیق دهد. اولین مسیر مصابقت داده‌شده انتخاب می‌شود، بنابراین ترتیب در routing.yml مهم است. به مثالی توجه کنید تا درک بهتری از مسیر یابی داشته باشید.
هنگامی که شما صفحه‌اصلی jobeet را درخواست می‌کنید، که URL آن /job است، اولین مسیری که مطابقت دارد همان default_index است. در یک الگو، کلماتی که با پیشوند (:) می‌آیند متغیر هستند. بنابراین الگوی /:module به این معنی است که / را با هرچیزی به دنبال آن مطابقت دهد. در مثال ما، متغیر module مقدار job را دارد. این مقدار با کد زیر می‌تواند در اکشن بازیابی شود:

$request->getParameter('module')

همچنین این مسیر‌یابی مقداری پیشفرض برای متغیر اکشن تعیین می‌کند. پس برای تمام URLهایی که با این مسیریاب مطابقت دارند، درخواست می‌تواند یک پارامتر action با مقدار index داشته باشد.
اگر شما درخواست صفحه job/show/id/1 را بدهید، Symfony آن را با الگوی بعدی مطابقت می‌دهد: :module/:action/* . در یک الگو (*) با مجموعه‌ای از متغیر/مقدار که بوسیله / از هم جدا شده‌اند مطابقت دارد.

Request parameter	Value
module	job
action	show
id	1

یادداشت: متغیر‌های module و action خاص هستند جون بوسیله Symfony برای تصمیم در رابطه با اجرای اکشن استفاده می‌شوند.

URL (آدرس) job/show/id/1 می‌تواند با استفاده از فراخوانی کمک‌کننده url_for() برای یک قالب ساخته شود:

url_for('job/show?id='.$job->getId())

همچنین شما می‌توانید نام مسیرتان را با پیشوند @ مشخص کنید:

url_for('@default?module=job&action=show&id='.$job->getId())

هر دو فراخوانی با هم مطابقت می‌کنند. اما دومی سریعتر است، زیرا مجبور به آزمایش تمامی مسیر‌یاب‌ها برای مطابقت بهتر نیست و برای پیاده‌سازی کمتر تلاش می‌کند. (نام ماژول و اکشن در URI داخلی حاضر نیستند).

سازش مسیر – Route Customazation

در حال‌حاضر، هنگامی که در‌خواست URL اسلش (/) را می‌دهید با صفحه خوش‌آمد سیمفونی مواجه می‌شوید. دلیل آن مطابقت URL با مسیر homepage است. اما می‌شود آن را به نفع خود تغییر داد. برای اینکار، متغیر module مسیر homepage را به job تغییر می‌دهیم.

# apps/frontend/config/routing.yml
homepage:
  url:   /
  param: { module: job, action: index }

حال می‌توانیم پیوند موجود در لوگوی jobeet را در layout با استفاده از مسیر homepage تغییر دهیم.



   echo url_for('@homepage') ?>">

خیلی راحت بود. به عنوان یک کار پیچیده‌تر، تغییراتی را برای job ایجاد کنید تا URL پر معنی‌تری داشته باشد:

/job/rayan-pardaz/gorgan-iran/1/web-developer

بدون دانستن هیچ اطلاعی راجع به jobeet و بدون حتی نگاه کردن به صفحه، می‌توان فهمید که شرکت رایان‌پرداز بدنبال یک توسعه دهنده وب برای کار کردن در گرگان-ایران می‌باشد!

یادداشت: برای رساندن اطلاعات به کاربران URLها بسیار مهم هستند. برای مثال زمانی که URL را در پست الکترونیکی کپی می‌کنید و یا وبسایت را برای موتور‌های جستجو بهینه می‌کنید.

طرح زیر با اینچنین URLهایی مطابقت دارد:

/job/:company/:location/:id/:position

فایل routing.yml را ویرایش کرده و مسیر job_show_user را در ابتدای آن اضافه کنید:

job_show_user:
  url:   /job/:company/:location/:id/:position
  param: { module: job, action: show }

اگر صفحه اصلی jobeet را refresh کنید، لینک مضاغل تغییری نکرده است و بدین خاطر است که برای ایجاد مسیر، شما باید تمامی متغیر‌های لازم را عبور دهید. پس فراخوانی url_for را در فایل indexSuccess.php تغییر دهید.

url_for('job/show?id='.$job->getId().'&company='.$job->getCompany().
  '&location='.$job->getLocation().'&position='.$job->getPosition())

همچنین یک URI داخلی می‌تواند بیان‌گر یک آرایه باشد.

url_for(array(
  'module'   => 'job',
  'action'   => 'show',
  'id'       => $job->getId(),
  'company'  => $job->getCompany(),
  'location' => $job->getLocation(),
  'position' => $job->getPosition(),
))

احتیاجات

روز اول آموزش درباره معتبرسازی و مدیریت خطاها برای دلایل درست بحث کردیم. سیستم مسیر‌یابی در ویژگی‌های معتبر سازی ایجاد شده است. هر متغیر الگو می‌تواند بوسیله یک عبارت تعیین شده که بوسیله requirements تعریف شده است، اعتبار سنجی شود:

job_show_user:
  url:   /job/:company/:location/:id/:position
  param: { module: job, action: show }
  requirements:
    id: \d+

requirements ذکر شده در بالا، عددی بودن id را ضروری می‌کند و در غیر این صورت مسیر تطبیق داده نمی‌شود.

کلاس مسیر

در حقیقت هر یک از تعاریف موجود در فایل routing.yml به یک شیء از کلاس sfroute تبدیل می‌شود. این کلاس‌ها می‌توانند بوسیله تعریف یک مشخصه کلاس در تعاریف مسیر تغییر کنند. اگر شما با پروتوکل http آشنا باشید، می‌دانید که متد‌های زیادی همچون GET، POST، HEA D، DELETE و PUT را تعریف می‌کند. سه‌تای اول در تمام مرورگر‌ها پشتیبانی می‌شوند و دو‌تای دیگر نه.
برای محدود کردن تطابق مسیر به برخی از متد‌های درخواست، می‌توانید کلاس مسیر را به sfRequestRoute تغییر داده و الزامی را برای متغیر مجازی sf_method اضافه کنید:

job_show_user:
  url:   /job/:company/:location/:id/:position
  class: sfRequestRoute
  param: { module: job, action: show }
  requirements:
    id: \d+
    sf_method: [get]

یادداشت: ملزوم کردن مسیر برای مطابقت با برخی از متد‌های http کاملاْ با استفاده ازsfWebRequest::isMethod() در اکشن برابری نمی‌کند، به این دلیل که مسیر‌یابی در صورت عدم تطابق به دنبال مسیر دیگری برای تطابق می‌گردد.

کلاس شیء مسیر – Object Route Class

URI جدید یک شغل واقعاْ طولانی و نوشتن ان سخت است (url_for(’job/show?id=’.$job->getId().’&company=’.$job->getCompany().’&location=’.$job->getLocation().’&position=’.$job->getPosition())) اما در قسمت قبل یاد گرفتیم که کلاس مسیر می‌تواند تغییر کند. برای مسیر job_show_user بهتر است که از sfPropelRoute استفاده کنیم. چون این کلاس برای مسیر‌هایی که اشیاء propel یا کلکسیونی از آنها را نمایش می‌دهند بهینه شده است.

job_show_user:
  url:     /job/:company/:location/:id/:position
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: show }
  requirements:
    id: \d+
    sf_method: [get]

مقدار مشخص شده برای options رفتار مسیر را بهینه می‌کند. در اینجا خصیصه model کلاس مدل کلاس مدل پروپل (JobeetJob) وابسته به مسیر را مشخص می‌کند، و خصیصه type هم تعیین می‌کند که این مسیر باید یک شیء را نشان دهد. (همچنین برای نمایشش کلکسیونی از اشیاء می‌توان از list استفاده کرد)
حالا مسیر job_show_user متوجه شده است که با JobeetJob رابطه دارد و بنابراین براحتی با url_for فراخوانی می‌شود:

url_for(array('sf_route' => 'job_show_user', 'sf_subject' => $job))

و یا تنها:

url_for('job_show_user', $job)

یادداشت: مثال اول برای زمانی که احتیاج به عبور آرگومنت‌های زیادی برای یک شیء است می‌تواند بسیار سودمند باشد.

چون تمام متغیر‌ها در این مسیر یک مقدار نظیر به نظیر قابل دستیابی در کلاس JobeetJob دارند، بخوبی کار می‌کند. (برای مثال، متغیر company با مقدار getCompany() جایگزین می‌شود)
اگر به URLهای ساخته شده نگاه کنید، خواهید دید که کاملا به چیزی که می‌خواهیم تبدیل نشده است.

http://jobeet.localhost/frontend_dev.php/job/Sensio+Labs/Paris%2C+France/1/Web+Developer

نیاز داریم تا مقادیر ستون‌ها را بصورت slug در آوریم. فایل JobeetJob را باط کرده و متد زیر را به آن اضافه کنید:

// lib/model/JobeetJob.php
public function getCompanySlug()
{
  return Jobeet::slugify($this->getCompany());
}
 
public function getPositionSlug()
{
  return Jobeet::slugify($this->getPosition());
}
 
public function getLocationSlug()
{
  return Jobeet::slugify($this->getLocation());
}

سپس فایل lib/Jobeet.class.php را ایجاد کرده و متد slugify را در آن اضافه کنید:

// lib/Jobeet.class.php
class Jobeet
{
  static public function slugify($text)
  {
    // replace all non letters or digits by -
    $text = preg_replace('/\W+/', '-', $text);
 
    // trim and lowercase
    $text = strtolower(trim($text, '-'));
 
    return $text;
  }
}

حالا سه تا دسترسی مجازی داریم:
getCompanySlug()، getPositionSlug() و getLocationSlug(). اینها مقادیر این سه ستون را در قالب متد slugify بر‌میگردانند. حالا می‌توانید نام اصلی ستون‌ها را با مشابه slug شده انها در مسیر job_show_user تغییر دهید:

job_show_user:
  url:     /job/:company_slug/:location_slug/:id/:position_slug
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: show }
  requirements:
    id: \d+
    sf_method: [get]

از آنجایی که کلاسی به سیستم اضافه شده است، قبل از refresh کردن صفحه اصلی لازم است تا cach را پاک کنید.

$ php symfony cc

حالا می‌توانید URLها را اینگونه مشاهده کنید:

http://jobeet.localhost/frontend_dev.php/job/sensio-labs/paris-france/1/web-developer

اما این تنها نصف داستان است. مسیر قابلیت آن را دارد که بر مبنای یک شیء ایجاد شود، اما در عین حال قابلیت پیدا کردن شیء مرتبط به URL معین را هم دارد. شیء مرتبط می‌تواند با متد getObject() از شیء مسیر بازیافت شود. هنگامی که یک در‌خواست ورودی تجزیه می‌شود ذخائر مسیر‌یابی شیء مسیر را برای استفاده شیء در اکشن‌ها تطبیق می‌دهند. بنابراین متد executeShow() را برای استفاده شیء مسیر برای بازگرداندن شیء jobeet تغییر دهید:

class jobActions extends sfActions
{
  public function executeShow(sfWebRequest $request)
  {
    $this->job = $this->getRoute()->getObject();
 
    $this->forward404Unless($this->job);
  }
 
  // ...
}

اگر سعی کنید شغلی را با یک id ناشناخته دریافت کنید، صفحه ۴۰۴ را با اخطاری متفاوت می‌بینید:

اخطار ۴۰۴ که توسط متد getRoute بوجود آمده است

این بدین خاطر است که اخطار ۴۰۴ بطور خودکار و بوسیله متد getRoute() پیش آمده. بنابراین می‌شود متد executeShow را ساده‌تر کرد:

class jobActions extends sfActions
{
  public function executeShow(sfWebRequest $request)
  {
    $this->job = $this->getRoute()->getObject();
  }
 
  // ...
}

نکته: اگر نمی‌خواهید مسیر به صفحه ۴۰۴ منتقل شود، می‌توانید مقدار allow_empty را به true تغییر دهید.

یادداشت: اشیا مرتبط یک مسیر بسیار تنبل هستند. و تنها در صورتی که شما متد getRoute() را فراخوانی کرده باشید، از پایگاه داده بازیافت می‌شوند.

مسیریابی در اکشن‌ها و قالب‌ها

در قالب، کمک کننده url_for آدرس‌های داخلی را به URLهای خارجی تبدیل می‌کند. برخی از کمک‌کننده‌های دیگر سیمفونی URLهای داخلی را در قالب آرگومنت می‌گیرند، همچون کمک‌کننده link_to که یک تگ a ایجاد می‌کند:

 echo link_to($job->getPosition(), 'job_show_user', $job) ?>

خروجی این کد در قالب HTML اینچنین است:

Web Developer

هر دوی این کمک‌کننده‌ها می‌توانند URLهای مطلق ایجاد کنند:

url_for('job_show_user', $job, true);
 
link_to($job->getPosition(), 'job_show_user', $job, true);

اگر می‌خواهید یک URL از یک اکشن ایجاد کنید، می‌توانید از متد generateUrl() استفاده کنید:

$this->redirect($this->generateUrl('job_show_user', $job));

خانواده متد‌های redirect

در قسمت قبل این آموزش، در مورد متد‌های forward صحبت کردیم. این متد‌ها درخواست جاری را بدون رفت و برگشت مرورگر به یک اکشن دیگر ارسال می‌کرد.
متد‌های redirect کاربر را به یک URL دیگر هدایت می‌کند. همچون forward می‌توانید از متد redirect()و یا متد های میانبر redirectIf() و redirectUnless() استفاده کنید.

مجموعه کلاس های مسیر

قبلاْ برای ماژول job، مسیر اکشن show را بهینه کردیم. اما URL سایر متد‌ها ( همچون index و new و …) بوسیله مسیر پیشفرض مدیریت می‌شوند:

default:
  url: /:module/:action/*

مسیر default راه خوبی بای شروع کد‌نویسی بدون مشخص کردن تعداد زیادی مسیر می‌باشد. اما چون مسیر به یک catch-all اثر می‌کند، نمی‌تواند برای نیاز‌های خاص ما پیکره‌بندی شود.
ار آنجایی که تمام اکشن‌های job با کلاس مدل JobeetJob مرتبط هستند، همانطور که قبلاْ برای اکشن show اینکار را انجام دادیم می‌توانیم براحتی یک مسیر دستی sfPropelRoute برای هر یک مشخص کنیم. اما همچون ماژول job مشخص کردن هفت اکشن کلاسیک برای یک مدل سخت است، گذشته از این می‌شود از کلاس sfPropelRouteCollection استفاده کرد. فایل routing.yml را باز کرده و تغییرات زیر را در ان اعمال کنید:

# apps/frontend/config/routing.yml
job:
  class:   sfPropelRouteCollection
  options: { model: JobeetJob }
 
job_show_user:
  url:     /job/:company_slug/:location_slug/:id/:position_slug
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: show }
  requirements:
    id: \d+
    sf_method: [get]
 
# default rules
homepage:
  url:   /
  param: { module: job, action: index }
 
default_index:
  url:   /:module
  param: { action: index }
 
default:
  url:   /:module/:action/*

مسیر job در بالا می‌تواند یک میانبر به هفت مسیر زیر را بطور خودکار ایجاد کند:

job:
  url:     /job.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: list }
  param:   { module: job, action: index, sf_format: html }
  requirements: { sf_method: get }
 
job_new:
  url:     /job/new.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: new, sf_format: html }
  requirements: { sf_method: get }
 
job_create:
  url:     /job.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: create, sf_format: html }
  requirements: { sf_method: post }
 
job_edit:
  url:     /job/:id/edit.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: edit, sf_format: html }
  requirements: { sf_method: get }
 
job_update:
  url:     /job/:id.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: update, sf_format: html }
  requirements: { sf_method: put }
 
job_delete:
  url:     /job/:id.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: delete, sf_format: html }
  requirements: { sf_method: delete }
 
job_show:
  url:     /job/:id.:sf_format
  class:   sfPropelRoute
  options: { model: JobeetJob, type: object }
  param:   { module: job, action: show, sf_format: html }
  requirements: { sf_method: get }

یادداشت: برخی از مسیر‌هایی که بوسیله sfPropelRouteCollection ایجاد شده‌اند، URLهای یکسان دارند. مسیریاب باز هم قابلیت استفاده از انها را دارد زیرا هرکدام نیاازمند یک متد خاص http هستند.

مسیر‌های job_delete و job_update متد‌هایی را نیاز دارند که توسط مرورگر پشتیبانی نمی‌شود، اما به این دلیل که Symfony آن را شبیه‌سازی می‌کند بدرستی کار می‌کنند. قالب _form.php را باز کنید تا یک مثال را مشاهده کنید:

// apps/frontend/modules/job/templates/_form.php

 if (!$form->getObject()->isNew()): ?>
  
 endif; ?>
 
 echo link_to(
  'Delete',
  'job/delete?id='.$form->getObject()->getId(),
  array('method' => 'delete', 'confirm' => 'Are you sure?')
) ?>

تمام کمک‌کننده‌های symfony می‌توانند شبیه‌سازی یک هر متد http را که باید به یک پارامتر خاص sf_method عبور داده‌شوند را بیان کنند.

یادداشت: سیمفونی پارامتر‌های خاص دیگری را همچون sf_method را هم دارد که همه با پیشوند sf_ شروع می‌شوند.
در مسیر‌های ساخته شده در بالا می‌توانید بقیه را مشاهده کنید، sf_format که هر یک در آینده توضیح داده خواهند شد.

اشکال‌زدایی مسیر

هنگامی که از مجموعه‌ی مسیر استفاده می‌کنید، بد نیست تا بعضی اوقات مسیر‌های ساخته شده را لیست کنیم. خروجی دستور app:routes تمام مسیر‌ها را برای application دریافتی می‌دهد:

$ php symfony app:routes frontend

همچنین می‌شود اطلاعات زیادی را برای اشکال‌زدایی مسیر بوسیله رد کردن نام آن در قالب یک آرگومنت داشته باشید:

$ php symfony app:routes frontend job_edit

مسیر‌های پیشفرض

مشخص کردن مسیر‌های مختلف برای تمامی URLها تمرین خوبی بود، همچون مسیر job که تمامی مسیر‌های لازم برای شرح دادن jobeet را مشخص می‌کرد.
مسیر‌های پیشفرض در فایل routing.yml را پاک کرده یا کامنت کنید.

# apps/frontend/config/routing.yml
#default_index:
#  url:   /:module
#  param: { action: index }
#
#default:
#  url:   /:module/:action/*

برنامه همچون قبل بخوبی کار می‌کند.

فردا می‌بینمتون

امروز اطلاعات جدید زیادی را دریافت کردیم. یاد گرفتیم که چگونه از فریم‌ورک مسیر‌یابی symfony استفاده کنیم و چگونه بوسیله آن URLها را از ساختار تکنیکی برنامه جدا کنیم.
فردا مفاهیم جدیدی را معرفی می‌کنیم.
پ‌ن – شما لطفاْ در صورت برخوردن با هر مشکلی در زمینه این آموزش شرح کامل رو اینجا بگذارید تا شاید بکار سایر کاربرا هم بیاد. ممنون

آموزش سیمفونی روز چهارم – کنترل کننده‌ها و نما‌ها

مهدی — Sun, 24 May 2009 15:50:34 +0000

در قسمت قبل دیدید که سیمفونی چگونه بوسیله کم کردن تفاوت‌های بین موتور‌های پایگاه داده و تبدیل عناصر رابطه‌ای به کلاس‌های رابطه‌ای اشیاء، مدیریت پایگاه داده را ساده می‌کند.
امروز قصد داریم تا ماژول job که دیروز ایجاد کردیم را توسعه دهیم. تمام چیزی که مورد نیاز است اینجا لیست شده است:

صفحه‌ای برای لیست کردن مشاغل
صفحه‌ای برای ایجاد شغل جدید
صفحه‌ای برای ویرایش مشاغل موجود
صفحه‌ای برای حذف مشاغل

اگرچه کدها برای استفاده حاضر هستند، اما نیاز است تا با بررسی مجدد، قالب‌ها را برای نزدیکی بیشتر Jobeet بهینه کنیم.

ساختار Model View Controllers – MVC

اگر شما تا کنون برای توسعه وب از فریم‌ورکی استفاده نکرده‌اید، احتمالاْ کدهای PHP خود را در قالب صفحات HTML می‌نوشتید.
احتمالاْ شیوه کار این فایل‌ها اینگونه بود: ارزش دهی و پیکره‌بندی کلی، منطق برنامه و رابطه ان با صفحات، بازیابی رکورد‌های پایگاه داده و در نهایت کدهای HTMLی که صفحه را پدید می‌آورند.
ایجاد تغییرات در چنین ساختاری، مخصوصاْ پس از گذشت مدتی بسیار سخت و طاقت فرسا است. و بدتر از آن زمانی است که شخص دیگری قصد ویرایش این کدها را داشته باشد.(کار گروهی)
اما این مشکل راه حل بسیار خوبی دارد.
رایج‌ترین ساختار برای مرتب سازی کدها در طراحی وب الگوی طراحی MVC است. بطور خلاصه، MVC راهی را برای مرتب سازی کد‌های شما با طبیعت خودش، مشخص می‌کند. این الگو کد‌ها را به سه لایه مجزا تقسیم می‌کند:
لایه مدل: منطق برنامه را مشخص می کند، سیمفونی نیز تمام فایل‌های مربوط به این لایه را در lib/model ذخیره می‌کند.
لایه نما: چگونگی نمایش است، (موتور قالب قسمتی از این لایه است) در سیمفونی لایه View بیشتر از کد‌های PHP ساخته می‌شود و در پوشه‌های مختلف template ذخیره می‌شود و در ادامه همین قسمت به آنها خواهیم پرداخت.
لایه کنترل کننده: قسمتی از کد‌ها که وظیفه فراخوانی Model را برای داده‌های عبور داده شده از لایه View را برای رندر شدن کلاینت را برعهده دارد.

چگونگی عملکرد ساختار MVC

هنگامی که در قسمت اول سیمفونی را نصب کردیم، دیدید که چگونه درخواست‌ها بوسیله front controllers مدیریت می‌شدند (index.php and frontend_dev.php).همین front controllers کار اصلی را انجام می‌دهند.
همانطور که دیروز هم دیدید، این عملیات منطقاْ در ماژول‌ها دسته بندی شده‌اند.
امروز با استفاده از مدل آزمایشی مطرح شده در روز دوم، صفحه اصلی و صفحه شغل را تغییر می‌دهیم و انها را پویا می‌کنیم.
در این راه موارد زیادی در فایل‌های مختلفی برای شرح ساختار پوشه‌های سیمفونی بکار می‌بریم و این کد‌ها را بین لایه‌ها تقسیم می‌کنیم.

طرح بندی – Layout

اگر به یک مدل نگاهی کنید، به شباهت اکثر این صفحات به هم پی می‌برید و همچنین می‌دانید که تکرار کد کار درستی نیست، چه کدهای HTML و چه PHP. بنابراین به راهی نیاز داریم تا از این کپی برداری‌ها جلوگیری شود.
یک راه برای این مشکل مشخص کردن هیدر و فوتر و include کردن آنها در هر قالب است.

ساختار Header - footer

اما در اینجا فایل‌های هیدر و فوتر شامل HTML معتبری نیستند. راه بهتری هم وجود دارد، بجای اینکار از یک الگوی طراحی دیگر استفاده می‌کنیم الگوی طراحی آذین داخلی (decorator).
این الگو برای حا این مشکل اینگونه عمل می‌کند:
قالب پس از رندر محتوا بوسیله یک قالب سراسری آراسته می‌شود، فراخوان کردن یک layout در سیمفونی.

ساختار layout

Layout پیشفرض یک application فایل layout.php را فراخوانی می‌کند که آن را در مسیر apps/frontend/templates می‌بینید.
این پوشه شامل تمامی قالب‌های سراسری برای application است. کد‌های زیر را با کد‌های موجود در layout.php عوض کنید.




  
    Jobeet - Your best job board
    
     include_javascripts() ?>
     include_stylesheets() ?>
  
  
    
      
        
          
            
          
 
          
            
              Ask for people
              
                Post a Job
              
            
 
            
              Ask for a job
              
                
                
                
                  Enter some keywords (city, country, position, ...)
                
              
            
          
        
      
 
      
         if ($sf_user->hasFlash('notice')): ?>
          
             echo $sf_user->getFlash('notice') ?>
          
         endif; ?>
 
         if ($sf_user->hasFlash('error')): ?>
          
             echo $sf_user->getFlash('error') ?>
          
         endif; ?>
 
        
           echo $sf_content ?>
        
      
 
      
        
          
            
            powered by 
            
            
          
          
            About Jobeet
            Full feed
            Jobeet API
            Affiliates

یک قالب سیمفونی، تنها یک فایل ساده PHP است. در طرح‌بندی قالب می‌توانید فانکشن‌های PHP را فراخوانی کنید و به متغیر‌های PHP اشاره کنید. $sf_content متغیر جالبی است که بوسیله خود فریم‌ورک مشخص شده است و شامل کد‌های HTML ساخته شده توسط اکشن‌ها می‌باشد.
اگر شما ماژول Job را مشاهده کنید (http://jobeet.localhost/frontend_dev.php/job)، خواهید دید که تمامی اکشن‌ها بوسیله این طرح آراسته شده‌اند.

سبک‌نامه‌ها، تصاویر و جاوا اسکریپت‌ها – CSS, Images and Java Scripts

این آموزش در مورد طراحی وب نیست بلکه در رابطه با توسعه آن است پس شما می‌توانید تمام موارد لازم برای این پروژه را از آدرس‌های زیر دریافت کنید.
دریافت تصاویر و ذخیره آنها در پوشه web/images
دریافت سبک‌نامه‌ها و ذخیره آنها در پوشه web/css

یادداشت: آیکن برنامه را هم می‌توانید از این ادرس دریافت کنید و در پوشه web ذخیره کنید.

خروجی layout برنامه

نکته: در حالت پیشفرض دستور generate:project سه پوشه جهت ذخیره ملزومات پروژه ایجاد می‌کند: web/images برای تصاویر، web/css برای فایل‌های استایل و پوشه web/js برای فایل‌های جاوا اسکریپت.
این ساختتار فقط یکی از قرارداد هایی است که توسط سیمفونی تعیین شده است، با این حال شما می‌توانید آنها را در هر نقطه‌ای تحت پوشه web ذخیره کنید.

خوانندگان ریزبین متوجه شده‌اند که در هیچ کجای layout اشاره‌ای به فایل‌ main.css نشده است. اما در خروجی HTML آن را مشاهده می‌کنیم! این چگونه ممکن است؟
سبک نامه‌ها بوسیله فانکشن include_stylesheets() در تگ Head فراخوانی شده است. این فانکشن یک کمک‌کننده را فراخوانی می‌کند.
کمک کننده خود یک فانکشن است که توسط سیمفونی تعیین شده است و می‌تواند پارامتر‌هایی را در قالب HTML برگرداند، کمک کننده باعث صرفه‌جویی در وقت می‌شود، آنها بسته‌های کوچکی هستند که خیلی اوقات در قالب بکار برده می‌شوند. کمک‌کننده include_stylesheets()تگ link را برای سبک‌نامه ایجاد می‌کند.
در این قسمت این سوال پیش می‌آید که کمک‌کننده از کجا متوجه می‌شود که کدام سبک‌نامه را باید include‌کند؟ با ویرایش فایل view.yml می‌توان لایه view را پیکره‌بندی نمود.
این پیکره‌بندی پیشفرض است که به کمک دستور generate:app ایجاد شده است:

# apps/frontend/config/view.yml
default:
  http_metas:
    content-type: text/html
 
  metas:
    #title:        symfony project
    #description:  symfony project
    #keywords:     symfony, project
    #language:     en
    #robots:       index, follow
 
  stylesheets:    [main.css]
 
  javascripts:    []
 
  has_layout:     on
  layout:         layout

فایل پیکره‌بندی view.yml بطور پیشفرض تنظیماتی را بروی تمامی قالب‌های application اعمال می‌کند. بعنوان مثال، مقدار stylesheet یک آرایه را برای سبک‌نامه‌هایی که باید در هر صفحه include شوند را مشخص می‌کند.

یادداشت: فایل view.yml به فایل main.css اشاره می‌کند نه به css/main.css. در حقیقت هر دو مشخصه با هم برابر هستند، زیرا مسیر‌های نسبی پیشوندی سیمفونی با /css همراهند.

اگر تعداد فایل‌های زیادی مشخص شده باشند، سیمفونی آنها را در جای مشخص include می‌کند.

stylesheets:    [main.css, jobs.css, job.css]

همچنین می‌توانید media را مشخص کرده و حتی پسوند css را هم حذف کنید!

stylesheets:    [main.css, jobs.css, job.css, print: { media: print }]

خروجی این پیکره‌بندی اینچنین است:

نکته: فایل view.yml طرح (layout) پیشفرض برای استفاده applicationها را نیز مشخص می‌کند. بطور پیشفرض نام آن layout است و بنابراین سیمفونی تمام صفحات را با فایل layout.php آرایش می‌دهد. همچنین شما می‌توانید این پروسه را با تغییر دادن مقدار has_layout به false کاملاْ غیر فعال کنید.

این رزوش کار می‌کند، اما فایل jobs.css مستلزم به وجود صفحه اصلی و فایل job.css به صفحه شغل می‌باشد. پیکره‌بندی view.yml می‌تواند بر مبنای per-module توسعه یابد. فایل view.yml را طوری تغییر می‌دهیم تا تنها فایل main.css را شامل شود.

# apps/frontend/config/view.yml
stylesheets:    [main.css]

برای توسعه جهت ماژول job یک فایل view.yml با محتوای زیر در مسیر apps/frontend/modules/job/config ایجاد می‌کنیم.

# apps/frontend/modules/job/config/view.yml
indexSuccess:
  stylesheets: [jobs.css]
 
showSuccess:
  stylesheets: [job.css]

در قسمت زیرین indexSuccess و showSuccess (اینها همام اسامی قالب هستند که با اکشن‌های index و show پیوست خورده‌اند، که در آینده بیشتر می‌بینیم) می‌توانید هر ورودی که زیر قسمت default پیدا می‌کنید را در فایل view.yml برنامه (application) توسعه دهید. تمام ورودی‌های خاص با پیکره‌بندی application ترکیب شده‌اند. همچنین شما می‌توانید برخی پیکره‌بندی‌ها را برای تمامی اکشن‌های یک ماژول بوسیله قسمت مخصوص all مشخص کنید.

اصول پیکره‌بندی در سیمفونی

برای بیشتر فایل‌های پیکره‌بندی سیمفونی، همان تنظیمات می‌تواند در سطوح مختلفی مشخص شود.

پیکره‌بندی پیشفرض در فریمورک تعیین شده است

پیکره‌بندی سراسری برای پروژه (در پوشه config)

پیکره‌بندی داخلی برای یک application (در پوشه apps/APP/config)

پیکره‌بندی داخلی انحصاری برای یک ماژول (apps/APP/MODULE/config)

در زمان اجرا، سیستم پیکره‌بندی تمام مقادیر را از فایل‌های مختلف در صورت یافتن و cach کردن با هم پیوند می‌دهد تا نتیجه آن بهترین کارایی را داشته باشد.

هنگامی که چیزی بوسیله فایل پیکره‌بندی، پیکره‌بندی شده باشد، همان را می‌توان بوسیله فایل‌های PHP کامل کرد. بجای ایجاد یک فایل view.yml برای ماژول job، بعنوان مثال می‌توان از کمک کننده use_stylesheet() برای include کردن استایل از یک قالب استفاده کرد:

همچنین می‌توانید برای include‌کردن یک استایل سراسری هم از این کمک‌کننده استفاده کنید.
انتخاب یک متد یک موضوع کاملاْ سلیقه‌ای است. فایل view.yml راهی را برای تخصیص مواردی به تمام اکشن‌ها و ماژول‌ها آماده می‌کند که اینکار در یک قالب شدنی نیست. اما با این حال پیکره‌بندی کاملاْ ایستا است و و استفاده از کمک‌کننده‌ها انعطاف زیادی دارد و علاوه بر آن هر چیز سر جای خودش است: مشخصات استایل و کد HTML.
ما برای پروژه jobeet از کمک‌کننده use-stylesheet() استفاده می‌کنیم. به همین علت شما می‌توانید فایل view.yml را حذف کنید.


 use_stylesheet('jobs.css') ?>
 

 use_stylesheet('job.css') ?>

یادداشت: همینطور برای فایل‌های javascript می‌توان از view.yml و یا کمک‌کننده use-javascript() استفاده کرد.

صفحه اصلی job

همانطور که در روز سوم مشاهده کردید، صفحه اصلی job بوسیله اکشن index از ماژول job ایجاد شد. اکشن index یک کنترل‌کننده صفحه است و پیوندی با قالب دارد، فایل indexsuccess.php نیز قسمت view است.

apps/
  frontend/
    modules/
      job/
        actions/
          actions.class.php
        templates/
          indexSuccess.php

اکشن

هر اکشن بوسیله یک مقدار از یک کلاس نمایش داده می‌شود. برای صفحه اصلی job، کلاس jobActions (نام ماژول بهمراه پسوند Actions) و متد executeIndex() (پیشوند execute بهمراه نام اکشن). این تمام مشاغل را از پایگاه داده بازیابی می‌کند:

// apps/frontend/modules/job/actions/actions.class.php
class jobActions extends sfActions
{
  public function executeIndex(sfWebRequest $request)
  {
    $this->jobeet_job_list = JobeetJobPeer::doSelect(new Criteria());
  }
 
  // ...
}

با دقت بیشتری به کد‌ها نگاه کنید: متد executeIndex() (کنترل‌کننده) مدل JobeetJobPeer را برای بازیافت تمامی مشاغل فراخوانی می‌کند.(new Criteria()) این تمام آرایه‌های اشیاء JobeetJob را که به شی jobeet_job_list اشاره دارد را باز می‌گرداند.
تمامی این خصوصیات شیء بطور خودکار از قالب عبور می‌کند (view). برای عبور داده‌ها از controllerها به view تنها یک خاصیت جدید ایجاد می‌شود.

public function executeFooBar(sfWebRequest $request)
{
  $this->foo = 'bar';
  $this->bar = array('bar', 'baz');
}

این کد متغیر‌های $foo و $bar را که در قالب قابل دسترسی هستند را ایجاد می‌کند.

قالب

بطور پیشفرض، نام قالب با توجه به تعداد داده‌های سیمفونی با یک Action یکپارچه شده است.(نام اکشن با پسوندی از success).
قالب indexSuccess.php برای تمامی مشاغل یک جدول HTML ایجاد می‌کند. این کد‌ها را مشاهده کنید:


 use_stylesheet('jobs.css') ?>
 
Job List
 
 foreach ($jobeet_job_list as $jobeet_job): ?>
     endforeach; ?>
  
  
    
      Id
      Category
      Type

      Created at
      Updated at
    
  
  
    
      
         echo url_for('job/show?id='.$jobeet_job->getId()) ?>">
           echo $jobeet_job->getId() ?>
        
      
       echo $jobeet_job->getCategoryId() ?>
       echo $jobeet_job->getType() ?>

       echo $jobeet_job->getCreatedAt() ?>
       echo $jobeet_job->getUpdatedAt() ?>
    
    

 
 echo url_for('job/new') ?>">New

Id	Category	Type	Created at	Updated at
echo url_for('job/show?id='.$jobeet_job->getId()) ?>"> echo $jobeet_job->getId() ?>	echo $jobeet_job->getCategoryId() ?>	echo $jobeet_job->getType() ?>	echo $jobeet_job->getCreatedAt() ?>	echo $jobeet_job->getUpdatedAt() ?>

در کد قالب، حلقه foreach کلیه اشیاء job را لیست می‌کند.($jobeet_job_list) و برای هر شغل ، هر یک از ستون‌ها مقداری در خروجی دارد. به خاطر داشته باشید که برای دسترسی به مقادیر ستون‌ها راه بسیار راحتی وجود دارد. فراخوانی متد دسترسی که با get شروع می‌شود و سپس نام ستون (فیلد) مورد نظر می‌آید. (به عنوان مثال، getCreatedAt() برای دسترسی به فیلد created_at بکار می‌رود)


 use_stylesheet('jobs.css') ?>
 

   foreach ($jobeet_job_list as $i => $job): ?>
      echofmod($i,2) ? 'even':'odd'?>">
         endforeach; ?>
  
           echo $job->getLocation() ?>
        
           echo url_for('job/show?id='.$job->getId()) ?>">
             echo $job->getPosition() ?>
          
        
         echo $job->getCompany() ?>

صفحه اصلی پروژه

در رابطه با تابع url_for() در قسمت بعد صحبت می‌کنیم.

قالب صفحه شغل

حالا نوبت ایجاد قالب صفحه شغل است.
فایل showSuccess.php را باز کرده و محتوای زیر را با محتوای پیشفرض تغییر دهید.


 use_stylesheet('job.css') ?>
 use_helper('Text') ?>
 

   echo $job->getCompany() ?>
   echo $job->getLocation() ?>
  
     echo $job->getPosition() ?>
     -  echo $job->getType() ?>
  
 
   if ($job->getLogo()): ?>
    
       echo $job->getUrl() ?>">
         echo $job->getLogo() ?>"
          alt=" echo $job->getCompany() ?> logo" />
      
    
   endif; ?>
 
  
     echo simple_format_text($job->getDescription()) ?>
  
 
  How to apply?
 
   echo $job->getHowToApply() ?>
 
  
    posted on  echo $job->getCreatedAt('m/d/Y') ?>
  
 
  
     echo url_for('job/edit?id='.$job->getId()) ?>">
      Edit

این قالب از متغیر $job برای نمایش اطلاعات شغل استفاده می‌کند. زیرا ما می‌توانیم متغیر عبور به قالب را از $jobeet_job به $job تغییر نام دهیم، شما هم می‌توانید این تغییر را در اکشن show ایجاد کنید.(دقت کنید که دو رویداد برای این متغیر وجود دارد)

// apps/frontend/modules/job/actions/actions.class.php
public function executeShow(sfWebRequest $request)
{
  $this->job = JobeetJobPeer::retrieveByPk($request->getParameter('id'));
  $this->forward404Unless($this->job);
}

توجه داشته باشید که برخی از لوازم دسترسی Propel آرگومنت‌هایی دریافت می‌کنند. از آنجایی که ستون created_at را از نوع timestamp تعریف کردیم فرمان getCreatedAt() نیازمند قالبی برای تاریخ می‌باشد.

$job->getCreatedAt('m/d/Y');

یادداشت: توضیحات شغل از کمک کننده simple_format_text() برای قالب بندی HTML استفاده می‌کند.
از آنجایی که این کمک‌کننده از خانواده کمک‌کننده‌های text است و بصورت پیشفرض لود نمی‌شود، ما آن را بصورت دستی و با استفاده از کمک کننده use_helper() بارگذاری کردیم.

صفحه نمایش شغل

شیار‌ها

خوب، حالا عنوان همه صفحات را در در تگ title لایه بندی مشخص می‌کنیم.

Jobeet - Your best job board

اما برای صفحه شغل، اطلاعات کاربردی‌تری باید مهیا کنیم. مثل نام شرکت و موقعیت شغل.
در سیمفونی هنگامی که یک ناحیه از layout برای نمایش وابسته به قالب باشد، به شیار‌ها (Slot) نیاز پیدا می‌کنیم.

ساختار شیار‌ها

شیاری را به layout اضافه می‌کنیم تا بتوان عنوان پویا ایجاد کرد.

// apps/frontend/templates/layout.php
<span style="color: #000000; font-weight: bold;"><?php</span> include_slot<span style="color: #009900;">(</span><span style="color: #0000ff;">'title'</span><span style="color: #009900;">)</span> <span style="color: #000000; font-weight: bold;">?></span>

هر شیار بوسیله یک نام مشخص می شود و می‌تواند بوسیله کمک‌کننده include_slot() نمایش داده شود. حالا در ابتدای فایل showSuccess.php از کمک‌کننده شیار برای صفحه شغل استفاده می‌کنیم.

// apps/frontend/modules/job/templates/showSuccess.php
 slot(
  'title',
  sprintf('%s is looking for a %s', $job->getCompany(), $job->getPosition()))
?>

اگر عنوان مجموعه‌ای برای ایجاد دارد، این کمک‌کننده می‌تواند در بلاکی از کد استفاده شود.

// apps/frontend/modules/job/templates/showSuccess.php
 slot('title') ?>
   echo sprintf('%s is looking for a %s', $job->getCompany(), $job->getPosition()) ?>
 end_slot(); ?>

برای برخی صفحات همچون صفحه اصلی، تنها به یک عنوان عمومی نیاز است. برای اینکار می‌توانیم یک عنوان پیشفرض برای صفحه مشخص کنیم.

// apps/frontend/templates/layout.php

  <span style="color: #000000; font-weight: bold;"><?php</span> <span style="color: #b1b100;">if</span> <span style="color: #009900;">(</span><span style="color: #339933;">!</span>include_slot<span style="color: #009900;">(</span><span style="color: #0000ff;">'title'</span><span style="color: #009900;">)</span><span style="color: #009900;">)</span><span style="color: #339933;">:</span> <span style="color: #000000; font-weight: bold;">?></span>
    Jobeet - Your best job board
  <span style="color: #000000; font-weight: bold;"><?php</span> <span style="color: #b1b100;">endif</span><span style="color: #339933;">;</span> <span style="color: #000000; font-weight: bold;">?></span>

اگر شیار‌ها مشخص شده باشند، کمک‌کننده مقدار صحیح را باز می‌گرداند، بنابر‌این هنگامی که عنوان خاصی مشخص نشده باشد، مقدار پیشفرض باز می‌گردد.

نکته: در گذشته مشاهده کردید که یک کمک‌کننده با include_ آغاز می‌شود که محتوای HTML تولید می‌کند و در بیشتر موارد همتایی دارد که با get_ آغاز می‌شود و تنها محتوا را بر‌میگرداند.
 include_slot('title') ?>
 echo get_slot('title') ?>
 
 include_stylesheets() ?>
 echo get_stylesheets() ?>

اکشن صفحه شغل

این صفحه بوسیله اکشن show در متد executeShow() از ماژول job ایجاد شده‌است.

class jobActions extends sfActions
{
  public function executeShow(sfWebRequest $request)
  {
    $this->job = JobeetJobPeer::retrieveByPk($request->getParameter('id'));
    $this->forward404Unless($this->job);
  }
 
  // ...
}

مانند اکشن index از کلاس JobeetJobPeer که برای بازگرداندن یک شغل استفاده می‌شد، حالا اینکار بوسیله متد retrieveByPk() انجام می‌گیرد.پارامتر این متد شناسه یکتای شغل است همان کلید اصلی. در قسمت بعد توضیح می‌دهیم که برای چه عبارت $request->getParameter(’id’)کلید اصلی شغل را باز‌ می‌گرداند.

نکته: کلاس‌های مدل ایجاد شده متد‌های بسیاری را برای ارتباط متقابل با اشیاء پروژه دارند. مدتی را صرف مطالعه کد‌های موجود در پوشه lib/om کنید تا به قدرت نهفته در آن پی ببرید.

اگر شغلی در پایگاه داده یافت نشد، کاربر را به صفحه ۴۰۴ می‌بریم. که در حقیقت کار متد forward404Unless() است.
این متد یک مقدار بولی بعنوان اولین آرگومنت می‌گیرد و اگر مقدار صحیح باشد، اجرای فعلی را متوقف می‌کند.
در حالت‌های خاص صفحه بنمایش درآمده برای کاربران متفاوت است. محیط prod و محیط dev را در تصاویر زیر مشاهده می‌کنید:

صفحه ۴۰۴ در محیط prod

صفحه ۴۰۴ در محیط dev

یادداشت: قبل از قرار دادن jobeet در سرور اصلی باید بدانید که چگونه می‌توان صفحه ۴۰۴ را ویرایش کرد.

خانواده متد‌های forward

فراخوانی forward404Unless در حقیقت برابری می‌کند با :
$this->forward404If(!$this->job);
که همچنین با این نیز برابری دارد:
if (!$this->job)
{
  $this->forward404();
}
متد forward404() تنها یک shortcut برای این است:
$this->forward('default', '404');
متد forward() به سمت یک اکشن دیگر از همان application هدایت می‌کند، همچنان که در مثال قبلی به اکشن ۴۰۴ ماژول default.
ماژول default همراه سیمفونی است و اکشن‌های پیشفرض را برای ۴۰۴، صفحات secure و صفحه لوگین مهیا می‌کند.

درخواست‌ها و جواب‌ها

هنگامی که در مرورگرتان صفحه /job و یا /job/show/id/1 را مرور می‌کنید، گردشی را براه انداخته‌اید. مرورگر درخواست‌ می‌دهد و سرور پاسخگویی باز می‌گرداند.
در گذشته دیدید که سیمفونی در‌خواست‌ها را در آبجکت sfWebRequest کپسوله می‌کند.(به متدexecuteShow() نگاهی بیندازید) و علاوه بر آن سیمفونی یک فریم‌ورک شیءگرا است. جواب‌ها هم یک آبجکت از کلاس sfWebResponse هستند. می‌توانید با فراخوانی $this->getResponse() به آبجکت پاسخ دسترسی داشته باشید. این اشیاء متد‌های مناسب زیادی برای دسترسی به اطلاعات توابع و متغیر‌های سراسری PHP تولید می‌کند.

درخواست‌ها

کلاس sfWebRequest کلیه آرایه‌های سراسری PHP از قبیل $_SERVER, $_COOKIE, $_GET, $_POST, and $_FILES می‌باشد.

Method name	PHP equivalent
`getMethod()`	`$_SERVER['REQUEST_METHOD']`
`getUri()`	`$_SERVER['REQUEST_URI']`
`getReferer()`	`$_SERVER['HTTP_REFERER']`
`getHost()`	`$_SERVER['HTTP_HOST']`
`getLanguages()`	`$_SERVER['HTTP_ACCEPT_LANGUAGE']`
`getCharsets()`	`$_SERVER['HTTP_ACCEPT_CHARSET']`
`isXmlHttpRequest()`	`$_SERVER['X_REQUESTED_WITH'] == 'XMLHttpRequest'`
`getHttpHeader()`	`$_SERVER`
`getCookie()`	`$_COOKIE`
`isSecure()`	`$_SERVER['HTTPS']`
`getFiles()`	`$_FILES`
`getGetParameter()`	`$_GET`
`getPostParameter()`	`$_POST`
`getUrlParameter()`	`$_SERVER['PATH_INFO']`
`getRemoteAddress()`	`$_SERVER['REMOTE_ADDR']`

قبلاْ با استفاده از متد getParameter() به پارامتر‌های درخواست‌ دسترسی پیدا کردیم که مقداری را از متغیر‌های سراسری GET، POST و یا PATH_INFO بر‌میگرداند.
اگر می‌خواهید مطمئن باشید کا مقادیر از متغیر خاصی می‌آیند باید به ترتیب از متد‌های getGetParameter(), getPostParameter(), and getUrlParameter() استفاده کنید.

یادداشت: هنگامی که قصد محدود‌کردن اکشن به متدی خاص را دارید، برای مثال همنگامی که می‌خواهید اطمینان حاصل کنید که یک فرم بوسیله POST ارسال شده است، می‌توانید از متد isMethod() استفاده کنید:
$this-&gt;forwardUnless($request-&gt;isMethod('POST'));

پاسخ‌ها

کلاس sfWebResponse متد‌های header() و setrawcookie() را پوشش می‌دهد.

Method name	PHP equivalent
`setCookie()`	`setrawcookie()`
`setStatusCode()`	`header()`
`setHttpHeader()`	`header()`
`setContentType()`	`header()`
`addVaryHttpHeader()`	`header()`
`addCacheControlHttpHeader()`	`header()`

مسلماْ کلاس sfWebResponse راهی را برای آماده کردن محتوای پاسخ (setContent()) و ارسال آن به مرورگر(send()) را ایجاد می‌کند.
بالاتر در رابطه با مدیریت CSSها و Jsها در فایل view.yml و قالب صحبت کردیم. در آخر هر دو تکنیک در جوابگویی شیء addStylesheet() و addJavascript() استفاده شدند.

نکته: کلاس‌های sfAction ، sfRequest و sfResponse متد‌های مفید و بسیار زیادی تولید می‌کنند. به این لینک مراجعه کنید تا بیشتر در رابطه با کلاس‌های داخلی سیمفونی بدانید.

فردا همدیگر را می‌بینیم

امروز به شرح الگوی طراحی استفاده شده در سیمفونی پرداختیم، کار با قالب را شروع و Layout و فایل‌های قالب را دستکاری کردیم. همچنین کمی آنها را پویا کردیم و این کار را به لطف شیار‌ها و اکشن‌ها انجام دادیم.
فردا در رابطه با url_for() که امروز بکار بردیم و یکپارچه کردن با مسیر‌یابی را فرا‌خواهیم گرفت.

آموزش سیمفونی ( Jobeet – قسمت سوم)

مهدی — Wed, 29 Apr 2009 20:20:09 +0000

بخش اول و دوم را خوانده‌اید؟ اگر نه که سعی کنید حتماْ آنها را مطالعه کنید و این کلمات (OOP, ORM, RAD, DRY, KISS, TDD, YAML, PEAR) را هم در گوگل جستجو کنید تا درک بهتری از ادامه آموزش‌ها داشته باشید.

آنهایی که علاقه زیادی به باز کردن ویرایشگر و کد‌نویسی دارند خوشحال باشند، چرا که آموزش امروز همین است.
Data Model را در Jobeet تعریف می‌کنیم، از ORM برای ارتباط با پایگاه داده استفاده می‌کنیم و اولین Model از برنامه را ایجاد می‌کنیم.

ارتباطات مدل

حکایت کاربری که در قسمت قبل به ان اشاره شد، شی اصلی پروژه ما را شرح می‌دهد: مشاغل، Affiliateها و دسته‌بندی‌ها.
در این قسمت دیاگرام موجودیت‌ها وابسته به هم را مشاهده می‌کنید:

دیاگرام موجودیت‌ها وابسته به هم نام

بعلاوه در شرح ستون‌ها، یک فیلد با نام created_at با جدول اضافه کردیم. سیمفونی اینچنین فیلد‌هایی را شناسایی کرده و مقدار ساعت جاری سیستم را به هنگاه ایجاد رکورد در آن ثبت می‌کند. همچنین فیلد updated_at، که مقدار زمان در هنگاه بروز شدن رکورد در آن ثبت می‌شود.

طرح (The Schema)

بدیهی است که برای ذخیره سازی مشاغل و … به یک پایگاه داده رابطه‌ای نیازمندیم. اما سیممفونی یک فریم‌ورک شی‌گرا می‌باشد، و ما می‌خواهیم تا در هر زمان بر اشیا کنترل داشته باشیم. یعنی، بجای نوشتن عبارات SQL برای بازیافت رکورد‌ها، از اشیا استفاده می‌کنیم تا سریعتر به جواب برسیم.
اطلاعات پایگاه داده‌های رابطه‌ای باید بصورت مدل اشیا (Object Model) نگاشته شوند. اینکار را با یک ابزار ORM می‌توان انجام داد.
سیمفونی، Propel و Doctrine را همراه خود دارد و ما در این آموزش از Propel استفاده می‌کنیم.
ORM برای ایجاد کلاس‌های مربوطه به شرح جداول و ارتباطات انها نیازمند است و ما دو راه برای ایجاد آن داریم: بوسیله introspecting an existing database و یا انجام دستی اینکار!

یادداشت: ابزاری وجود دارند که امکان ساخت پایگاه داده را بصورت گرافیکی (برای مثال Fabforce’s Dbdesigner) و تولید مستقیم یک فایل schema.xml (بوسیله DB Designer 4 TO Propel Schema Converter ).

از آنجایی که پایگاه داده ما هنوز ایجاد نشده، فایل طرح را به شکل دستی ایجاد می‌کنیم و فایل خالی config/schema.yml را بدین صورت ویرایش می‌کنیم.

# config/schema.yml
propel:
jobeet_category:
id:           ~
name:         { type: varchar(255), required: true, index: unique }
 
jobeet_job:
id:           ~
category_id:  { type: integer, foreignTable: jobeet_category, foreignReference: id, required: true }
type:         { type: varchar(255) }
company:      { type: varchar(255), required: true }
logo:         { type: varchar(255) }
url:          { type: varchar(255) }
position:     { type: varchar(255), required: true }
location:     { type: varchar(255), required: true }
description:  { type: longvarchar, required: true }
how_to_apply: { type: longvarchar, required: true }
token:        { type: varchar(255), required: true, index: unique }
is_public:    { type: boolean, required: true, default: 1 }
is_activated: { type: boolean, required: true, default: 0 }
email:        { type: varchar(255), required: true }
expires_at:   { type: timestamp, required: true }
created_at:   ~
updated_at:   ~
 
jobeet_affiliate:
id:           ~
url:          { type: varchar(255), required: true }
email:        { type: varchar(255), required: true, index: unique }
token:        { type: varchar(255), required: true }
is_active:    { type: boolean, required: true, default: 0 }
created_at:   ~
 
jobeet_category_affiliate:
category_id:  { type: integer, foreignTable: jobeet_category, foreignReference: id, required: true, primaryKey: true, onDelete: cascade }
affiliate_id: { type: integer, foreignTable: jobeet_affiliate, foreignReference: id, required: true, primaryKey: true, onDelete: cascade }

یادداشت: اگر مصمم هستید که پایگاه داده خود را بوسیله عبارات SQL ایجاد کنید، می‌توانید بوسیله اجرای دستور propel:build-schema یک schema.yml مشابه ایجاد کنید.
$ php symfony propel:build-schema
طرح یا همان schema برگردانی از موجودیت‌های مرتبط با هم در قالب YAML است که یک زبان ساده برای شرح دادن داده‌ها می‌باشد.

فایل schema.yml شامل توضیحاتی از کلیه جداول و ستون‌های آنها است. هر ستون توضیحاتی اینچنین دارد:

type: نوع ستون
required: اگر می‌خواهی ستونی اجباری باشد، مقدار ان را true قرار می‌دهید.
index: اگر می‌خواهید ستونی را به عنوان ایندکس تعیین کنید مقدار آن را true و یا برای یکتا بودن مقدار unique را وارد کنید.
primaryKey: تعیین ستونی به عنوان کلید اصلی جدول
foreignTable, foreignReference: مشخص کردن ستونی به عنوان کلید خارجی به جدولی دیگر.

ستون‌هایی که با مقدار ~ تنظیم شده‌اند، همان معنی null را می‌دهد. (id, created_at, and updated_at) که سیمفونی خودکار بهترین پیکره بندی را در نظر می‌گیرد.(کلید اصلی برای id و مقدار timestamp برای created_at و updated_at)

یادداشت: ویژگی ON DELETE رفتار کلید‌های خارجی را تعیین می‌کند، propel از CASCADE و SETNUL و RESTRICT پشتیبانی می‌کند.
برای مثال، هنگامی که رکورد یک شغل پاک می‌شود، تمام jobeet_category_affiliateهای مرتبط با رکورد‌ها باید به صورت خودکار از پایگاه داده‌ پاک شوند و یا …

پایگاه داده

تمامی پایگاه‌ داده‌هایی که توسط PDO پشتیبانی می‌شوند، در فریمورک سیمفونی نیز قابلیت کاربرد را دارند. PDO یک لایه مستقل پایگاه داده (DataBase abstraction layer) همراه PHP است که باعث می‌شود تا برنامه شما با هر پایگاه داده‌ای براحتی کار کند و نیاز به تغییر در کد‌ها را نداشته‌ باشید. ما برای این پروژه از MySQL استفاده می‌کنیم.

$ mysqladmin -uroot -pmYsEcret create jobeet

یادداشت: شما برای انتخاب سایر پایگاه‌های داده مجازید. سازگار کردن کد‌هایی که می‌نویسیم کار دشواری نیست زیرا از ORM برای نوشتن کد‌های SQL استفاده می‌کنیم.

در اینجا باید به سیمفونی اطلاع دهیم که برای این پروژه از پایگاه داده MySQL استفاده کند.

$ php symfony configure:database "mysql:host=localhost;dbname=jobeet" root password

دستور configure:database برای دسترسی به پایگاه داده، سه مقدار دریافت می‌کند: PDO DNS، نام کاربری و کلمه عبور.

یادداشت: این دستور پیکره‌بندی پایگاه داده را در فایل config/databases.yml قرار می‌دهد. بنابراین بجای استفاده از دستور می‌توتنید اینکار را بطور دستی انجام دهید.

ORM

به شما پیشنهاد می‌کنم اگر از هویت ORM مطلع نیستید این مطلب را حتماْ بخوانید و سپس ادامه این مطلب را مطالعه فرمائید.

به لطف توضیحات پایگاه داده در فایل schema.yml، می‌توانیم از برخی وظایف و دستورات درونی propel برای ساخت عبارات SQLی که برای ایجاد جداول مورد نیاز است استفاده کنیم:

$ php symfony propel:build-sql

دستور propel:build-sql عبارات را در پوشه data/sql ایجاد می‌کند، و موتور پایگاه داده را برای پیکره‌بندی ما بهینه می‌کند.

# snippet from data/sql/lib.model.schema.sql
CREATE TABLE `jobeet_category`
(
`id` INTEGER  NOT NULL AUTO_INCREMENT,
`name` VARCHAR(255)  NOT NULL,
PRIMARY KEY (`id`),
UNIQUE KEY `jobeet_category_U_1` (`name`)
)Type=InnoDB;

در حقیقت برای ایجاد جداول به دستور propel:insert-sql نیاز است.

$ php symfony propel:insert-sql

از آنجایی که این دستور جداول فعلی را قبل از ایجاد جداول جدید حذف می‌کند، شما ملزم هستید تا این عملیات را تائید کنید. با اضافه کردن ویژگی –no-confirmation باعث کنار گذاشتن هر سوالی خواهید شد.

$ php symfony propel:insert-sql --no-confirmation

نکته: برای هر ابزار در خط فرمان سیمفونی یک راهنمای توکار تعبیه شده که شما می‌توانید به شکل زیر از آنها استفاده کنید:
$ php symfony help propel:insert-sql
این راهنما لیستی از مقادیر و متغیر‌های قابل استفاده در دستور مورد نظر را لیست می‌کند و مقدار پیشفرض هر کدام را به شما نشان خواهد داد و برای شما چندین مثال کاربردی را ذکر می‌کند.

همچنین ORM کلاس‌هایی را که برای نگاشتن رکورد‌های جدول بروی اشیا است را تولید می‌کند.

$ php symfony propel:build-model

وظیفه propel:build-model این است که فایل های PHPرا در پوشه lib/model ایجاد می‌کند تا بتوانند با پایگاه داده تعامل داشته باشند.
با نگاهی به فایل‌های ایجاد شده، متوجه خواهید شد که propel برای هر جدول ۴ کلاس ایجاد کرده است. بطور مثال برای جدول jobeet_job

JobeetJob: اشیای این کلاس رکوردی از جدول jobeet_job را نمایش می‌دهند. این کلاس در حالت پیشفرض خالی است.
BaseJobeetJob: این کلاس والد کلاس JobeetJob است و هر زمان که propel:build-model را اجرا کنید، این کلاس مقدم است، بنابراین تمام تنظیمات بروی کلاس JobeetJob اعمال می‌شوند.
JobeetJobPeer: این کلاس یک متد ایستا را مشخص می‌کند که اساساْ مجموعه‌ای از اشیا JobeetJob را بر می‌گرداند. کلاس بطور پیشفرض خالی است.
BaseJobeetJobPeer: کلاس والد کلاس JobeetJobPeer است و هر زمان که propel:build-model را اجرا کنید، این کلاس مقدم است، بنابراین تمام تنظیمات بروی کلاس JobeetJobPeer اعمال می‌شوند.

مقادیر ستون یک رکورد بوسیله مدل آبجکت که از برخی ابزار دسترسی و تغییر استفاده می‌کنند قابل دستکاری هستند.

$job = new JobeetJob();
$job-&gt;setPosition('Web developer');
$job-&gt;save();
 
echo $job-&gt;getPosition();
 
$job-&gt;delete();

همچنین می‌توان بوسیله مرتبط ساختن اشیا به یکدیگر، کلید‌های خارجی را مشخص کرد.

$category = new JobeetCategory();
$category-&gt;setName('Programming');
 
$job = new JobeetJob();
$job-&gt;setCategory($category);

دستور propel:build-all یک میانبر برای وظایفی است که در این بخش آنها را اجرا می‌کنیم. در حال حاضر اجرای این وظیفه منجر به ساخت فرم‌ها و اعتبار‌سنج‌ها برای کلاس‌های مدل jobeet می‌شود.

$ php symfony propel:build-all --no-confirmation

در پایان این قسمت اعتبار سنج‌ها را در عمل مشاهده می‌کنید و فرم‌ها نیز در بخش ۱۰ کاملاْ شرح داده می‌شوند.
با توجه به اینکه شما می‌خواهید پس از این را مشاهده کنید، سیمفونی خودکار کلاس‌های PHP را برای شما لود می‌کند، که بدین معنی است که هیچگاه نیاز به استفاده از require در کدتان ندارید. و این تنها یکی از بیشمار مواردی است که سیمفونی بطور خودکار برای توسعه دهندگان فراهم می‌کند. اما نکته اینجا است که هر زمان شما کلاس جدیدی ایجاد کردید، نیازمند به پاک کردن cache هستید. از آنجایی که propel:build-model کلاس‌های جدید زیادی تولید می‌کند، باید cache را پاک کنید.

$ php symfony cache:clear

نکته: دستورات سیمفونی از یک فضای نام و یک نام برای وظیفه ساخته شده‌اند. هر کدام می‌توانند کوتاه و مختصر شوند تا شباهت کمتری با سایر دستورات داشته باشند. دستورات زیر با دستور cache:clear برابری می‌کنند:
$ php symfony cache:cl
$ php symfony ca:c
اما این وظیفه بقدری استفاده می‌شود که بهتر است بسیار کوتاه‌تر شود!
$ php symfony cc

داده‌های اولیه

جداول پایگاه‌داده ساخته شده‌اند، اما داده‌ای در آنها وجود ندارد. برای هر برنامه تحت وب ۳ نوع داده وجود دارد:

داده‌های اولیه: برنامه برای کار کردن به این داده‌ها نیازمند است. برای مثال، Jobeet به دسته‌بندی‌های اولیه نیازمند است. در غیر این صورت هیچ کس نمی‌تواند شغلی را ثبت کند! همانطور که برای آماده‌سازی بستر ورود به backend برنامه نیز به یک کاربر مدیر نیازمندیم.
داده‌های آزمایشی: این داده‌ها برای آزمایش برنامه مورد استفاده قرار می گیرند.
داده‌های کاربران: داده‌هایی که طی عمر معمولی برنامه توسط کاربران تولید می‌شوند.

هر زمانی که سیمفونی جداول پایگاه داده را ایجاد می‌کند، تمامی داده‌ها از بین می‌روند! می‌توان برای حفظ این داده‌ها یک اسکریپت PHP نوشت و یا یک عبارت SQL را در برنامه MySQL اجرا کرد. اما چون این نیازی است که بسیار مورد استفاده قرار می‌گیرد، راه بهتر با سیمفونی وجود دارد.
ایجاد فایل YAML در پوشه data/fixtures/ و استفاده از دستور propel:data-load برای بارگذاری انها در پایگاه داده.
ابتدا فایل‌های fixture زیر را ایجاد کنید:

# data/fixtures/010_categories.yml
JobeetCategory:
design:        { name: Design }
programming:   { name: Programming }
manager:       { name: Manager }
administrator: { name: Administrator }
 
# data/fixtures/020_jobs.yml
JobeetJob:
job_sensio_labs:
category_id:  programming
type:         full-time
company:      Sensio Labs
logo:         sensio-labs.gif
url:          http://www.sensiolabs.com/
position:     Web Developer
location:     Paris, France
description:  |
You've already developed websites with symfony and you want to
work with Open-Source technologies. You have a minimum of 3
years experience in web development with PHP or Java and you
wish to participate to development of Web 2.0 sites using the
best frameworks available.
how_to_apply: |
Send your resume to fabien.potencier [at] sensio.com
is_public:    true
is_activated: true
token:        job_sensio_labs
email:        job@example.com
expires_at:   2010-10-10
 
job_extreme_sensio:
category_id:  design
type:         part-time
company:      Extreme Sensio
logo:         extreme-sensio.gif
url:          http://www.extreme-sensio.com/
position:     Web Designer
location:     Paris, France
description:  |
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut
enim ad minim veniam, quis nostrud exercitation ullamco laboris
nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor
in reprehenderit in.
 
Voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa
qui officia deserunt mollit anim id est laborum.
how_to_apply: |
Send your resume to fabien.potencier [at] sensio.com
is_public:    true
is_activated: true
token:        job_extreme_sensio
email:        job@example.com
expires_at:   2010-10-10

یادداشت: فایل fixture شغل به دو فایل تصویری اشاره دارد که می‌توانیدآنها را از اینجا و اونجا دریافت کرده و در پوشه uploads/jobs/ ذخیره کنید.

فایل‌های fixture در قالب YAML نوشته شده‌اند و Model Object‌ها را مشخص می‌کنند. توسط نامی یکتا برچسب خورده‌اند.(برای مثال، ما دو شغل را با job_sensio_labs و job_extreme_sensio نشانه گذاری کردیم) این برچسب‌ها در پیوند اشیا مرتبط با هم کاربرد‌های بزرگی دارند، بدون مشخص کردن کلید‌های اصلی (که بارها بطور خودکار افزایش پیدا کرده و نمی‌تواند تنظیم شود) برای مثال: دسته بندی شغل job_sensio_labs مقدار programming است که مسلماْ برچسب programming را بخود می‌گیرد.

نکته: در فایل YAML، هنگامی که یک رشته بخواهد شامل شکست خط شود(به خط بعد منتقل شود)، (همچون ستون Description) می‌توان با استفاده از پایپ ( | ) برای تعریف محتوای چند خطی استفاده کرد.

اگر‌چه فایل‌های fixture می‌توانند شامل اشیایی از یک یا چند مدل باشند، اما ما می‌توانیم به ازای هر مدل یک فایل fixture ایجاد کنیم.

نکته: شماره‌های پیشوندی برای نام فایل‌ها. این یک راه ساده برای کنترل بروی نظم در بارگذاری داده‌ها است. در مراحل بعدی اگر نیازی به درج یک فایل fixture جدید پیدا کردیم، براحتی می‌توانیم شماره‌ای را از بین این‌دو انتخاب کنیم.

در یک فایل fixture، احتیاجی به مشخص کردن مقادیر تمام ستون ها نیست. در این صورت سیمفونی مقادیر مشخص شده پیشفرض در نمای پایگاه داده استفاده می‌کند و از propel برای بارگذاری داده‌ها در وایگاه داده بهره می‌برد.
تمامی این رفتار‌های درونی (نظیر تنظیمات خودکار در ستون‌های craeted_at و updated_at) و رفتار‌هایی که ممکن است به کلاس‌های مدل اضافه کنید، فعال هستند.
بارگیری داده‌های اولیه بوسیله اجرای دستور propel:data-load بسیار آسان است.

$ php symfony propel:data-load

نکته: دستور propel:build-all-load میانبری برای دستور propel:build-all است که به دنبال دستور propel:data-load می‌آید.

مشاهده نتیجه کار در مرورگر

ما از محیط خط فرمان بسیار استفاده کردیم، اما اینکار زیاد هیجان انگیز نیست، مخصوصاْ برای اینکار (طراحی وب) حالا تمام چیز‌هایی که برای ساخت صفحه وبی که با پایگاه داده تعامل کند را داریم.
ببینید که چگونه باید لیست مشاغل را مشاهده کنیم، چگونه مشاغل فعلی را ویرایش کنیم و چگونه شغلی را پاک کنیم. با توجه به توضیحات روز اول، یک پروژه سیمفپنی مجموعه ای از Applicationها است. Applicationها به ماژول‌ها تقسیم شده‌اند و یک ماژول از کد‌های PHP تشکیل شده که نشان‌ دهنده ویژگی‌های Application هستند (ماژول API)، و یا مجموعه‌ای از کار‌هایی هستند که کاربران می‌توانند بروی Model Object انجام دهند.(ماژول شغل)
سیمفونی بطور خودکار ماژولی برای تهیه ویژگی‌های پایه مدل را ایجاد می‌کند.

$ php symfony propel:generate-module --with-show --non-verbose-templates frontend job JobeetJob

همانطور که به همراه بیشتر دستورات سیمفونی، برخی از فایل‌ها و پوشه‌ها در پوشه apps/frontend/modules/job/ ایجاد می‌شود، دستور propel:generate-module هم یک ماژول job برای مدل JobeetJob را در قسمت Frontend برنامه ایجاد می‌کند.

پوشه	شرح
`actions/`	اکشن‌های ماژول
`templates/`	قالب ماژول

فایل‌ actions/actions.class.php تمامی action‌های مجاز را برای ماژول job مشخص می‌کند.

نام اکشن	شرح
`index`	نمایش رکورد‌های جدول
`show`	نمایش فیلد‌ها و مقادیر انها برای رکورد‌‌های مشخص
`new`	نمایش فرم برای ایجاد یک رکورد جدید
`create`	ایجاد یک رکورد جدید
`edit`	نمایش فرم برای ویرایش رکورد جاری
`update`	بروز‌رسانی رکورد با توجه به مقادیر ثبت شده
`delete`	حذف یک رکورد معین از جدول

حال شما می توانید ماژول job را در مرورگر آزمایش کنید.

http://jobeet.localhost/frontend_dev.php/job

نمایش ماژول job را در مرورگر

اگر بخواهید شغلی را ویرایش کنید، می‌توانید استثنا (F – ی – L – ت – R) قائل شوید زیرا سیمفونی یک نمونه متنی (text representation) از دسته‌بندی‌ها را احتیاج دارد.
یک نمونه شی PHP می‌تواند بوسیله متد منطقی __toString() مشخص شود. نمونه متنی یک رکورد دسته‌بندی باید در کلاس مدل JobeetCategory مشخص شده باشد.

// lib/model/JobeetCategory.php
class JobeetCategory extends BaseJobeetCategory
{
public function __toString()
{
return $this-&gt;getName();
}
}

حال هر زمان که سیمفونی به یک نمونه متنی احتیاج داشته باشد، متد __toString() فراخوانی شده و یک نام را برای دسته بندی بر می‌گرداند. ازآنجایی که چندین نقطه به یک نمونه متنی احتیاج داریم، این متد را برای هر کلاس مدلی تعریف می‌کنیم.

// lib/model/JobeetJob.php
class JobeetJob extends BaseJobeetJob
{
public function __toString()
{
return sprintf('%s at %s (%s)', $this-&gt;getPosition(), $this-&gt;getCompany(), $this-&gt;getLocation());
}
}
 
// lib/model/JobeetAffiliate.php
class JobeetAffiliate extends BaseJobeetAffiliate
{
public function __toString()
{
return $this-&gt;getUrl();
}
}

اینگونه شما می‌توانید شغل جدیدی ساخته و یا آن را ویرایش کنید. سعی کنید یک فیلد ضروری را خالی گذاشته و یا داده‌های غیر مجاز وارد کنید. درست است!!! سیمفونی بطور خودکار و با توجه به نمای پایگاه داده (database schema) اعتبار سنج‌های کلی را ایجاد کرده است.

فردا همدیگر را می‌بینیم

کار امروز تمام شد. ما کد‌هایی را نوشتیم که خالی از اشکال نیست. با این‌حال باآنها کار کردیم و نتیجه هم گرفتیم. اما به یاد داشته باشید این بدان معنا نیست که کد‌ها عاری از حفره و مشکل هستند.
اگر شما هنوز احساس خستگی نمی‌کنید و می‌خواهید کد‌های نوشته شده را مطالعه کنید تا متوجه چگونگی کار کردن آن شوید که هیچ، اما در غیر اینصورت منتظر باشید تا در قسمت بعدی در رابطه با معماری MVC با هم صحبت کنیم.

همچون سایر روز‌ها کد‌های امروز هم در SVN موجود می‌باشند. از تگ release_day_03 استفاده کنید.

$ svn co http://svn.jobeet.org/propel/tags/release_day_03/ jobeet/

آموزش سیمفونی ( Jobeet – قسمت دوم)

مهدی — Wed, 22 Apr 2009 19:28:48 +0000

توصیه می‌کنم قبل از مطالعه این مطلب حتماْ قسمت اول را مطالعه فرمائید.

تا کنون هیچ کدی با زبان php ننوشته‌ایم. با این حال محیط کاریمان را راه‌اندازی کردیم، پروژه‌ای خالی در سیمفونی ایجاد کردیم و از برخی پیشفرض‌های امنیتی خاطر جمع شدیم.
حالا شما می‌توانید صفحه پیشفرض را برای پروژه‌های خالی سیمفونی مشاهده کنید.

اما بیشتر از اینها باید پیش رفت. باید تمام جزئیات ریز و درشت توسعه برنامه در سیمفونی را فرا گرفت. اما امروز دقایقی را به شرح احتیاجاتی می‌پردازیم که در این پروژه به آنها نیاز است.

زیر و بم پروژه

Jobeet یک تخته اعلانات کاریابی کدباز است. براحتی قابل استفاده و توسعه است و می‌تواند در وبسایت شما هم بکار رود. از آخرین تکنولوژی‌های وب۲ بهره می‌گیرد و همچنین برای ارتباط متقابل با فعالیت‌های برنامه نویسی feed و API تولید می‌کند.

داستان پروژه jobeet

قبل از شیرجه به درون کد‌ها و شروع کد‌نویسی، لازم است تا اندکی بیشتر به شرح پروژه بپردازیم. در بخش‌های پائین، به تشریح خصوصیاتی می‌پردازیم که قصد اجرای آن را در نسخه اول پروژه داریم.

وبسایت Jobeet چهار نوع کاربر دارد.
Admin: صاحب وبسایت!
User: جهت یافتن شغل وبسایت را مشاهده می‌کند.
Poster: برای پست کردن یک شغل به وبسایت می‌آید.
Affiliate: برخی از مشاغل را در وبسایت خود منتشر می‌کند.

پروژه Jobeet دو بخش را در بر دارد. یکی بخش frontend ، مکانی که کاربران با وبسایت تعامل دارند (F1 تا F7) و دیگری Backend، جایی که مدیر، به مدیریت خود می‌پردازد. (B1 تا B3)
بخش Backend محافظت شده است و برای دسترسی به آن اعتبار نامه نیاز است.

F1: صفحه اصلی که کاربران آخرین مشاغل را در آن مشاهده می‌کنند:

این مشاغل بر حسب دسته و مکان‌شان ذخیره شده‌اند و هرچه جدید‌تر باشند، بالاتر قرار می‌گیرند.
در این صفحه تنها مکان، وضعیت و شرکت هر شغل قابل مشاهده است. برای هر دسته تنها ۱۰ شغل آخر به نمایش در می‌آیند و یک پیوند امکان لیست شدن مشاغل موجود در یک دسته بندی را ایجاد می‌کند. (F2)
کاربر می‌تواند لیست موجود را با توجه به نیازش پالایش کند (F3) و یا شغلی جدید ارسال کند. (F5)

F2: کاربر می‌تواند بین مشاغل موجود در یک دسته پرس و جو کند:

هنگامی که کاربر بروی نام دسته و یا More Jobs کلیک می‌کند، تمامی مشاغل موجود در آن دسته را در لیستی که بر حسب تاریخ مرتب شده است را مشاهده می‌کند.
لیست‌ها بصورت ۲۰ لینک در هر صفحه، صفحه بندی شده‌اند.

F3: کاربر می‌تواند لیست را با استفاده از کلمه‌ای کلیدی پالایش کند:

کاربران می‌توانند با توجه به کلمه‌ای کلیدی به جستجو بپردازند. این کلمات کلیدی در مکان، وضعیت، دسته و یا مشخصات شرکت جستجو می‌شوند.

F4: کاربر بروی عنوان شغل کلیک می‌کند تا جزئیات را بررسی کند:

کاربران می‌توانند یک شغل را از لیست انتخاب کرده و جزئیات آن را مشاهده کنند.

F5: کاربر می‌توتند شغلی جدید پست گند:

کاربران شغلی را پست می‌کنند. این شغل از قسمت‌های جداگانه‌ای از اطلاعات تشکیل شده است که به شرح زیر می‌باشد:

شرکت
نوع (full-time, part-time, freelance)
لوگو
آدرس وب (URL)
وضعیت
مکان
دسته (کاربران می‌توانند دسته مورد نظر را از لیست انتخاب کنند)
توضیحات (URL و Email بطور اتوماتیک افزوده می‌شوند)
چگونگی اعمال (URL و Email بطور اتوماتیک افزوده می‌شوند)
عمومیت (آیا امکان انتشار شغل در سایت Affiate میسر است یا خیر)
پست الکترونیک

برای ارسال یک شغل نیازی به ایجاد اشتراک نیست. این پروسه تنها در ۲ مرحله صورت می‌گیرد، ابتدا کاربر فرم تشریح شغل را تکمیل می‌کند، سپس پیش نمایش اطلاعات را در صفحه‌ای مشاهده کرده و ان را تائید می‌کند. حتی اگر کاربر اشتراکی نداشته باشد در آدرسی مخصوص می‌تواند شغل ارسالی را ویرایش کند (این امکان بوسیله یک توکن که پس از ایجاد شغل ایجاد می‌شود، محافظت می‌شود)
هر شغل به مدت ۳۰ روز Online می‌ماند (قابل تنظیم در پنل مدیریت B2) کاربر می‌توتند دوباره آن را فعال کند و یا مدت آن را تمدید کند تا بیشتر از ۳۰ روز Online بماند، اما تنها در صورتی که کمتر از ۵ روز به پایان تاریخ انقضا مانده باشد.

F6: کاربر خود را به عنوان affiliate تعریف می‌کند:

کاربران جهت استفاده از APIهای Jobeet، باید خود را به عنوان affiliate تعریف کنند و برای اینکار باید اطلاعات زیر را وارد کنند:

نام
پست الکترونیک
آدرس وب سایت

اشتراک affiliate در قسمت مدیریت تائید می‌شود (B3)، هنگامی که فعال شد، affiliate توکنی را برای استفاده از API بوسیله پست الکترونیک دریافت می‌کند. پس از این مراحل affiliate می‌تواند مشاغل را از یک دسته معتیر انتخاب کند.

F7: یک affiliate لیست مشاغل جاری را بدست می‌آورد:

affiliate می‌تواند لیست مشاغل جاری را با فراخوانی API بدست آورد. این لیست می‌تواند در قالب‌های JSON, XML و یا YAML باشد.
لیست هم شامل اطلاعات عمومی معتبر یک شغل می‌باشد. همچنین affiliate می‌تواند برخی از مشاغل و یا تنها دسته‌ای خاص از آنها را نمایش دهد.

B1: مدیر وبسایت را پیکره‌بندی می‌کند:

یک مدیر می‌تواند دسته‌های معتبر در سایت را ویرایش کند.

B2: مدیریت مشاغل بر عهده مدیر است:

یک مدیر می‌تواند شغلی را ویرایش و یا آن را حذف کند.

B3: مدیریت affiliateها نیز بر عهده مدیر است:

مدیر می‌تواند affiliate را ایجاد و یا ان را ویرایش کند. او می‌تواند اشتراک affiliateها را فعال کند و یا انها را ناتوان سازد. هنگامی که مدیر اشتراک affiliate را فعال می‌کند، سیستم یک توکن منحصر به فرد را برای استفاده affiliate ایجاد می‌کند.

بقیه داستان jobeet را در روز‌های آینده بخوانید

در برنامه نویسی و توسعه وب، هیچگاه نباید از روز اول به کد‌نویسی پرداخت. ابتدا باید نیاز‌ها را شناسایی و بررسی کنیم. این همان کاری‌است که امروز انجام شد!

آغاز کار با سیمفونی

مهدی — Wed, 08 Apr 2009 14:41:00 +0000

به نظر بنده بهترین مرجع برای شروع سیمفونی (Symfony) همان پروژه Jobeet است که به شما آموزش می‌دهد که چگونه بوسیله این فریم‌ورک در مدت ۲۴ ساعت (روز) یک برنامه تحت وب کار آمد را بصورت کاملاْ حرفه‌ای تولید کنید. البته اشاره به این نکته هم خالی از لطف نیست که این آموزش ۲۴ قسمتی یکی از مزایای سیمفونی در مقابل رقبای قدرتمند خود همچون Zend و CakePHP است. چرا که تولید برنامه‌ای با این قدرت در همان ابتدای راه، نشان دهنده قدرت و در عین حال سادگی سیمفونی می باشد.

در ادامه به ترجمه بخش اول این کتاب (جدای از مقدمه) می‌پردازیم. (طبق معمول ترجمه‌ای پر از اشکال که به عظمت سیمفونی ببخشید)

امروز چکار می‌کنیم؟

۲۴ ساعت زمان مناسبی برای توسعه یک برنامه توسط سیمفونی است (در سال صرفه جویی و اصلاح الگوی مصرف، واقعا تا این حد صرفه جویی در زمان کار بسیار پسندیده‌ای است). امروز هیچ کدی نمی‌نویسیم. اما بدون نوشتن حتی یک خط کد، می‌توانیم مزایای استفاده از سیمفونی را تنها با راه اندازی یک پروژه جدید درک کنیم.

هدف امروز ما، راه اندازی محیط توسعه و نمایش صفحه‌ای از برنامه در مرورگر است. اینکار شامل نصب سیمفونی، ایجاد برنامه و تنظیمات وب سرور می‌شود.

پیشنیاز‌ها

قبل از هر چیز محیط توسعه رو چک می‌کنیم. یک وب سرور (ترجیحاْ Apache)، یک موتور پایگاه داده (ترجیحاْ MySQL) و PHP نسخه ۵.۲.۴ و یا جدید‌تر!

در سیمفونی به وفور از خط فرمان استفاده می‌کنیم، پس بهتر است تا از سیستم‌های مبتنی بر Unix (ترجیحاْ لینوکس OpenSUSE که دلیلش هم بعداْ می‌گم!!!) استفاده کنید. البته ویندوز هم می‌شه ولی نه با این کیفیت!

در ادامه این مباحث بیشتر توجه ما به روی سیمفونی است و فرض را بر این می‌گذاریم که شما اطلاعات خوبی راجع به PHP 5 و OOP یا همون Object Oriented Programming می‌دانید.

برای آشنایی خیلی سریع با برنامه نویسی شی‌گرا این تاپیک را مطالعه کنید.

نصب سیمفونی

ابتدا برای میزبانی فایل‌های مرتبط با پروژه Jobeet یک پوشه می‌سازیم و بهتر است این‌ کار را توسط خط فرمان انجام دهیم.

$ mkdir -p /home/sfprojects/jobeet
$ cd /home/sfprojects/jobeet

حالا یک پوشه هم برای فایل‌های کتابخانه‌ای سیمفونی می‌سازیم

$ mkdir -p lib/vendor

صفحه نصب در سایت رسمی پروژه تمام نسخه‌های مجاز رو لیست و مقایسه کرده. این آموزش نیز برای ورژن ۱.۲ نوشته شده است. به صفحه نصب این نسخه بروید و در قسمت زیرین Source Download، آرشیوی از فرمت‌های tgz و یا zip رو می‌تونید پیدا کنید. آرشیو را دانلود کرده و در پوشه‌ای که به تازگی ایجاد کردید قرار دهید و سپس آن را از حالت فشرده خارج کنید و البته باز هم سعی کنید اینکار را با استفاده از Terminal انجام دهید!

$ cd lib/vendor
$ tar zxpf symfony-1.2.2.tgz
$ mv symfony-1.2.2 symfony
$ rm symfony-1.2.2.tgz

از آنجایی که پیکر‌بندی PHP بواسطه وجود نسخه‌های مختلف بسیار متفاوت است، ما نیاز به بررسی پیکره‌بندی PHP داریم تا از وجود حداقل‌ها برای سازگاری با سیمفونی آگاه شویم.

اسکریپت configuration checker رو از خط فرمان اجرا می‌کنیم.

$ cd ../..
$ php lib/vendor/symfony/data/bin/check_configuration.php

اگر مشکلی باشد در خروجی به شما تذکر خواهد داد و راه حل رفع ان را نیز به شما می‌گوید. همچنین می‌توان این آزمایش را بدون استفاده از خط فرمان در مرورگر اجرا کرد. فایل اسکریپت رو در شاخه ریشه وب کپی کنید و به آدرس مربوطه بروید و هرگز فراموش نکنید که بعد از پاک کردن فایل رو پاک کنید.

$ rm web/check_configuration.php

تصویر شماره ۱-۱ / configuration checker

اگر در خروجی خطایی داده نشد نشان دهنده نصب درست سیمفونی است. شما می‌توانید بوسیله خط فرمان ورژن سیمفونی را مشاهده نمائید.

$ php lib/vendor/symfony/data/bin/symfony -V

اگر شما هم مثل بنده مشتاقی هستید، که بعید می‌دونم!!! اما احتمالاْ مشتاق هستید که در رابطه با ابزار‌هایی که سیمفونی در خط فرمان فراهم کرده اطلاعاتی کسب کنید. کلمه symfony را در خط فرمان تایپ کنید تا لیستی از آپشن‌ها و وظایف رو مشاهده کنید.

$ php lib/vendor/symfony/data/bin/symfony

خط فرمان سیمفونی بهترین دوست شما است، زیرا بهترین تسهیلات رو برای شما مهیا می‌کند و قابلیت‌های شما را در فعالیت‌های روزانه همچون پاک کردن Cach، ایجاد کد‌ها و … بهبود می‌بخشد.

راه‌اندازی پروژه

در سیمفونی، Applicationها اشتراک همان مدل‌های داده هستند که در پروژه‌ها جمع‌آوری می‌شوند. برای Jobeet ما دو Application داریم: یکی Frontend و دیگری Backend.

ایجاد پروژه

فرمان generate:project را از پوشه Jobeet اجرا کنید که در حقیقت وظیفه ساخت پروژه را دارد.

$ php lib/vendor/symfony/data/bin/symfony generate:project jobeet

این دستور وظیفه ایجاد ساختار پیش‌فرض فایل‌ها و پوشه‌ها را به عهده دارد.

پوشه	شرح
`apps/`	میزبانی تمامی Applicationهای پروژه
`cache/`	فایل‌های Cache شده از فریم‌ورک
`config/`	فایل‌های پیکره‌بندی پروژه
`lib/`	کتابخانه‌ها و کلاس‌های پروژه
`log/`	فایل‌های log فریم‌ورک
`plugins/`	افزونه‌های نصب شده
`test/`	دستگاه آزمایش اساسی فایل‌ها
`web/`	پوشه ریشه وب (در پایین می‌بینیم)

نکته : چرا سیمفونی فایل‌های زیاد تولید می‌کند؟ یکی از مزایای استفاده از یک فریم‌ورک full-stack این است که توسعه شما را استاندارد می‌کند. هر توسعه دهنده ای با دانسته‌هایی اندک از سیمفونی، میتواند از پروژه‌های سیمفونی حمایت کند. تنها با چند دقیقه وقت گذاشتن می‌شه داخل کد‌ها رفت، حفره‌های آنها را گرفت و یا ویژگی‌های جدیدی رو به انها افزود.

وظیفه generate:project ساخت یک میان‌بر در شاخه اصلی پروژه است تا هنگام اجرای وظایف (Task) کمترین تعداد کاراکتر را تایپ کنید.

همچنین از این به بعد، بجای استفاده بجای استفاده از مسیر‌های کامل و صحیح به Applicationهای سیمفونی از میان‌برها استفاده می‌کنیم.

ایجاد Application

حالا نمای جلوی برنامه را بوسیله دستور generate:app ایجاد می‌کنیم.

$ php symfony generate:app --escaping-strategy=on --csrf-secret=UniqueSecret frontend

نکته :به دلیل اجرایی بودن فایل‌های میان‌بر سیمفونی، از این پس کاربران unix می‌توانند بجای تمام رخداد‌های php symfony از ./symfony استفاده کنند.

اساس یک application روی نام است، زیرا یک شناسه است، وظیفه generate:app ایجاد ساختار پیش‌فرض پوشه‌هایی است که برنامه نیاز دارد و تحت پوشه apps/frontend قرار می‌گیرند.

پوشه	شرح
`config/`	فایل‌های پیکره‌بندی application
`lib/`	کتابخانه‌ها و کلاس‌های application
`modules/`	کد‌های application (توجه به MVC)
`templates/`	فایل‌های سراسری قالب

نکته : تمام دستورات سیمفونی باید در پوشه ریشه پروژه اجرا شوند، مگر اینکه بطور صریح طور دیگری اعلام کنند.

علاوه بر اینها به هنگام فراخوانی وظیفه generate:app از دو خصیصه امنیتی مرتبط عبور می‌کنیم.

–escaping-strategy : فعال کردن فرار خروجی برای جلوگیری از حملات XSS
–csrf-secret : فعال کردن اجازه ورود به نشست‌ها در فرم‌ها برای جلوگیری از حملات SCRF

با اعمال این دو خصیصه اختیاری به وظیفه، می‌توانیم آینده توسعه خودمان را برای بیشتر از ۲ آسیب‌پذیری رایج در وب امن کنیم. درسته! سیمفونی بطور خودکار اقدامات امنیتی را از طرف ما انجام می‌دهد.

یادداشت : اگر در رابطه با XSS و CSRF چیزی نمی‌دانید، وقتی را به یادگیری درباره این دو آسیب‌پذیری امنیتی اختصاص دهید.

مسیر سیمفونی

شما می‌توانید نسخه استفاده شده برای پروژه را با استفاده از دستور زیر بدست آورید.

$ php symfony -V
or
$ symfony -V

این دستور مسیر پوشه نصب سیمفونی را نیز نمایش می‌دهد که می‌توان آن را در آدرس config/ProjectConfiguration.class.php پیدا کرد:

// config/ProjectConfiguration.class.php
require_once '/Users/mehdi/work/symfony/dev/1.2/lib/autoload/sfCoreAutoload.class.php';

برای بهبود قابلیت حمل، مسیر مطلق را با یک مسیر نسبی تعویض می‌کنیم.

// config/ProjectConfiguration.class.php
require_once dirname(__FILE__).'/../lib/vendor/symfony/lib/autoload/sfCoreAutoload.class.php';

حالا شما می‌توانید پروژه را بروی هر سیستمی انتقال دهید و اون به درستی کار کند.

محیط

اگر به پوشه /web نگاه کنید، دو فایل PHP را در آن پیدا می‌کنید: index.php‌ و frontend_dev.php. این فایل‌ها برای فراخوانی front controller هستند: تمام درخواست‌ها به application بواسطه آنها ساخته شده‌اند.

اما چرا دو عدد front controller داریم، در حالی که تنها یک application ساخته‌ایم؟!

هر دو فایل، همان application را نمایش می‌دهند اما برای محیط‌های متفاوت. زمانی که شما application را توسعه می‌دهید، نیاز به یک محیط توسعه دارید، مگر توسعه شما مستقیماْ بروی سرور باشد.

Development environment : این محیطی است که توسعه دهندگان بهنگام کار بروی برنامه‌ها برای اضافه کردن خصوصیات و رفع حفره‌ها از ان استفاده می‌کنند.

Test environment : این محیط در آزمایش‌های خودکار مورد استفاده قرار می‌گیرد.

Staging environment : این محیز برای استفاده مشتری (کارفرما) برای امتحان و گزارش حفره‌ها و قابلیت‌های فراموش شده است.

Production environment : این محیط هم اخر کار است و برای ارائه نهایی است.

اما چرا تهیه محیط‌های مختلف؟ برای مثال در محیط‌ توسعه برای راحتی در کار اشکال زدایی به log شدن تمام جزئیات درخواست‌ نیاز است. اما سیستم Cache باید غیر فعال باشد تا تمامی تغییرات ایجاد شده در کد اعمال شوند. بنابراین بهینه سازی محیط توسعه برای اینکار ضروری است. بهترین مثال زمانی است که یک مشکل خاص در برنامه رخ می‌دهد. برای کمک به توسعه دهنده سیمفونی این مشکل خاص رو بهمراه تمامی اطلاعاتش در رابطه با درخواست‌ جاری، در مرورگر نمایش می‌دهد.

تصویر شماره ۲-۱ / Exception dev

اما در محیط ارائه Cache فعال است و به خوبی کار می‌کند. برنامه نیز پیغام‌های خطا را بجای اتفاق‌های خاص نمایش می‌دهد. بنابراین محیط ارائه برای نمایش و فعالیت کاربران بهینه شده است.

تصویر شماره ۳-۱ / Exception prod

محیط‌های سیمفونی دارای تنظیمات جداگانه‌ای هستند. فریم‌ورک سیمفونی بهمراه این سه می‌آید: dev، test و prod. در روز ۲۲ (قسمت ۲۲ آموزش) چگونگی ساخت یک محیط جدید رو فرا می‌گیرید و البته محیطstaging .

اگر فایل front controller را باز کنید، محتویات زیر را مشاهده خواهید کرد که برای تنظیمات محیط است.

// web/index.php
&lt;?php
 
require_once(dirname(__FILE__).'/../config/ProjectConfiguration.class.php');
 
$configuration = ProjectConfiguration::getApplicationConfiguration('frontend', 'prod', false);
sfContext::createInstance($configuration)-&gt;dispatch();

یادداشت : تعیین یک محیط برای سیمفونی حتی از ایجاد یک front controller هم آسان‌تر است. در آینده می‌بینیم که چطور می‌توان تنظیمات یک محیط را تغییر داد.

راه‌اندازی وب سرور : شیوه اشتباه

در بخش قبلی، پوشه‌ای برای میزبانی Jobeet ایجاد کردیم. اگر شما این پوشه را در مکانی تحت وب سرور سیستم خود ایجاد کردید، در مرورگر به پروژه خود دسترسی دارید.

درسته! چون پیکره‌بندی وجود ندارد راه‌اندازی خیلی سریع انجام شد. اما تلاش برای دسترسی به فایل config/databases.yml در مرورگر شما برای درک نتایج بد این تنبلی.اگر کاربران بدونند که وبسایت شما با سیمفونی توسعه پیدا کرده، می‌توانند به بسیاری از فایل‌های مهم دسترسی پیدا کنند.

هرگز اینکار را در سرور انجام ندهید و بخش بعدی رو برای یادگیری چگونگی راه‌اندازی وب سرور مطالعه کنید.

راه‌اندازی وب سرور : شیوه مطمئن

بهترین‌ کار این است که تنها فایل‌هایی که باید توسط مرورگر دسترسی داشته باشند همچون فایل‌های سبک‌نامه، جاوا و تصاویر را در پوشه اصلی قرار داده که البته بهتر است بطور پیشفرض در پوشه /web قرار دهیم.

اگر نگاهی به این پوشه انداخته باشید زیر پوشه‌هایی رو می‌بینید که دارایی آنها، فایل‌ها (سبک‌نامه، تصاویر و …) و دو فایل front controller هستند.front controllerها تنها فایل‌های PHP هستند که نیاز دارند تا در پوشه ریشه وب سرور قرار بگیرند. همه فایل‌های دیگر PHP می‌توانند از دید مرورگر مخفی شوند. که این ایده خوبی از لحاظ امنیتی است.

پیکره‌بندی وب سرور

حالا زمان ان رسیده تا پیکره‌بندی Apache را تغییر دهیم.

فایل پیکره‌بندی httpd.conf را باز کرده و این کد‌ها را در خط اخر ان اضافه کنید.

# Be sure to only have this line once in your configuration
NameVirtualHost 127.0.0.1:8080
 
# This is the configuration for Jobeet
Listen 127.0.0.1:8080
 
<VirtualHost 127.0.0.1:8080>
DocumentRoot "/home/sfprojects/jobeet/web"
DirectoryIndex index.php
<Directory "/home/sfprojects/jobeet/web">
AllowOverride All
Allow from All
</Directory>
 
Alias /sf /home/sfprojects/jobeet/lib/vendor/symfony/data/web/sf
<Directory "/home/sfprojects/jobeet/lib/vendor/symfony/data/web/sf">
AllowOverride All
Allow from All
</Directory>
</VirtualHost>

این پیکره‌بندی، Jobeet را در آدرس http://localhost:8080/ قابل دسترس می‌کند

شما می‌توانید این عدد را با هر عدد دیگری تغییر دهید. اما بهتر است از اعداد بزرگتر از ۱۰۲۴ استفاده کنید. زیرا این اعداد نیازی به اجازه مدیر سیستم ندارند.

آزمایش پیکره‌بندی جدید

Apache را دوباره راه‌اندازی کنید (restart). دسترسی به jobeet را با استفاده از آدرس بالا امتحان کنید.

تصویر شماره ۴-۱ / Congratulations

یادداشت : اگر ماژول mod-rewrite شما در apache فعال باشد می‌توانید عبارت index.php را از انتهای آدرس حذف کنید. اینکار به برکت قوائد دوباره نویسی پیکره‌بندی شده در فایل /web/.htaccess امکان پذیر است.

همچنین باید دسترسی برنامه را در محیط توسعه امتحان کنیم.

http://jobeet.localhost/frontend_dev.php/

نوار ابزار عیب‌یابی را باید در گوشه بالا سمت راست مشاهده کنید که شامل آیکون کوچک SF که نام اختصاری سیمفونی است می‌باشد.

تصویر شماره ۵-۱ / Web debug toolbar

نوار ابزار فوق در تمام صفحات در محیط توسعه حاضر است و دسترسی به اطلاعات زیادی را بوسیله کلیک بروی سایر تب‌ها به شما می‌دهد. اطلاعاتی همچون پیکر بندی فعلی برنامه، وقایع درخواست جاری، دستورات SQL اجرا شده در موتور پایگاه داده، اطلاعات حافظه و اطلاعات زمان.

Subversion

بهترین کار این است که هنگام توسعه یک برنامه از SVN استفاده کنیم.

برخی از مزایای استفاده از SVN :

با اطمینان کار کردن

برگشت به نسخه قبلی در صورت شکست تغییرات ایجاد شده
امکان کار کردن موثر و واقعی بیشتر از چند نفر بر روی یک پروژه
دسترسی به تمامی نسخه‌های منتشر شده پی در پی

در این بخش به شرح چگونگی کار کردن با SVN بوسیله سیمفونی می‌پردازیم. اگر شما از هر ابزار کنترل کد دیگری استفاده می‌کنید، توضیح در مورد چگونگی SVN بسیار راحت خواهد شد.

تصور را بر این می‌گذاریم که شما به یک سرور subversion دسترسی دارید و می‌توانید بوسیله http با اون کار کنید.

نکته : اگر سرور subversion در دسترس ندارید، می‌توانید به رایگان در google code یک مخزن ایجاد کنید و یا عبارت free subversion را در google جستجو کنید و …

ابتدا مخزن پروژه Jobeet را ایجاد می‌کنیم.

$ svnadmin create /path/to/jobeet/repository

ساختار اصلی پوشه‌ها را در سیستم ایجاد می‌کنیم.

$ svn mkdir -m "created default directory structure" http://svn.example.com/jobeet/trunk http://svn.example.com/jobeet/tags http://svn.example.com/jobeet/branches

و پوشه خالی trunk را بررسی می‌کنیم.

$ cd /home/sfprojects/jobeet
$ svn co http://svn.example.com/jobeet/trunk/ .

سپس محتویات پوشه /cache و /log را پاک می‌کنیم، زیرا نیازی به درج انها در مخزن نداریم.

$ rm -rf cache/* log/*

حالا از دسترسی‌های پوشه‌های /cache و /log اطمینان حاصل می‌کنیم تا سرویس دهنده وب بتواند در آنها بنویسد.

$ chmod 777 cache/ log/

حالا تمامی فایل‌ها و پوشه‌ها را وارد می‌کنیم.

$ svn add *

از آنجایی که نیازی به فایل‌های موجود در پوشه‌های /cache و /log نداریم باید آنها را در ignore list قرار دهیم.

$ svn propedit svn:ignore cache

ویرایش‌گر متن پیشفرض برای SVN باید راه افتاده باشد. Subversion باید تمامی محتوای موجود در این پوشه را ignore کند.

ذخیره کنید و خارج شوید. شما موفق شدید.

این مراحل را برای پوشه log تکرار کنید.

$ svn propedit svn:ignore log

و وارد کنید:

در نهایت، این تغییرات رو در مخزن اعمال کنید

$ svn import -m "made the initial import" . http://svn.example.com/jobeet/trunk

فردا (بخش دوم) همدیگر را خواهیم دید

وقت امروز تمام شد. با این حال حتی اگر صحبت کردن در رابطه با سیمفونی را آغاز نکردیم، اما یک محیط توسعه پایدار داریم، در رابطه با بهترین شیوه‌های توسعه وب بحث کردیم و هم اکنون برای کد نویسی آماده شده‌ایم.

فردا مشخص می‌کنیم که چه برنامه‌ای را خواهیم نوشت و درباره ملزوماتی که برای اتمام پروژه در طول مدت آموزش به آن نیاز داریم بحث خواهیم کرد.

یادداشت : اگر می‌خواهید کد امروز و یا هر روز دیگری را بررسی کنید، کدها بصورت روز به روز در مخازن رسمی Jobeet یافت می‌شوند.(http://svn.jobeet.org/propel)

برای مثال شما می‌توانید با استفاده از تگ release_day_01 کد‌های امروز را دریافت کنید.
$ svn co http://svn.jobeet.org/propel/tags/release_day_01/ jobeet/

Moshtaghi.ir » php

کتاب مرجع برای سیمفونی

عنوان بخش‌های این کتاب عبارتند از:

استفاده از وردپرس به عنوان یک فریم‌ورک PHP

تمامی پلتفرم در یک صفحه PHP

نوشتن یک صفحه وب کامل در ۱۰ ثانیه

چرا و چه هنگام باید برای ایجاد صفحه وب از وردپرس استفاده کنیم؟

چه کارهایی را می‌توان با این تکنیک انجام داد؟

سیمفونی فینالیست شد

آموزش سیمفونی روز ششم – مطالب بیشتری از لایه مدل

ضوابط شیء Propel

اشکال‌زدایی SQLهای ایجاد شده توسط propel

ترتیب شیء

اطلاعات بیشتر راجع داده‌های اولیه

پیکره‌بندی دستی

دوباره سازی – Refactoring

دسته‌ بندی‌های صفحه اصلی

echo $category ?>

حدود نتایج

داد‌های اولیه پویا

ایمن کردن صفحه شغل

پیوند به صفحه مشاغل

فردا همدیگر را می‌بینیم

انتخاب یک IDE مناسب php و سازگاری آن با symfony (قسمت اول)

رنگ‌بندی کدها – Syntax highlighting

اتمام خودکار کد – Code completion

ناوبری – Navigation

نمایش خطا‌ها و اخطارها

دوباره سازی و سازندگی کد – Refactoring and code generation

اشکال‌زدایی – Debugging

سیستم کنترل نسخه – Versioning system

خصوصیات سمت مشتری – Client-side features

کدام IDE تمام این ویژگی‌ها را شامل می‌شود؟

IDEهای مبتنی بر Eclipse

NetBeans

نتیجه اخلاقی

و اما ادامه ماجرا

آموزش سیمفونی روز پنجم – مسیر‌یابی

URLها

پیکره‌بندی مسیر‌یابی

سازش مسیر – Route Customazation

echo url_for('@homepage') ?>">

احتیاجات

کلاس مسیر

کلاس شیء مسیر – Object Route Class

مسیریابی در اکشن‌ها و قالب‌ها

خانواده متد‌های redirect

مجموعه کلاس های مسیر

اشکال‌زدایی مسیر

مسیر‌های پیشفرض

فردا می‌بینمتون

آموزش سیمفونی روز چهارم – کنترل کننده‌ها و نما‌ها

ساختار Model View Controllers – MVC

طرح بندی – Layout

Ask for people

Ask for a job

سبک‌نامه‌ها، تصاویر و جاوا اسکریپت‌ها – CSS, Images and Java Scripts

اصول پیکره‌بندی در سیمفونی

صفحه اصلی job

اکشن

قالب

Job List

قالب صفحه شغل

echo $job->getCompany() ?>

echo $job->getLocation() ?>

echo $job->getPosition() ?> - echo $job->getType() ?>

How to apply?

شیار‌ها

اکشن صفحه شغل

خانواده متد‌های forward

درخواست‌ها و جواب‌ها

درخواست‌ها

پاسخ‌ها

فردا همدیگر را می‌بینیم

آموزش سیمفونی ( Jobeet – قسمت سوم)

ارتباطات مدل

طرح (The Schema)

پایگاه داده

ORM

داده‌های اولیه