آموزش نرم افزار ۲۰۱۸ PhpStorm

• جزئیات
• نوع محتواآموزش تصویری

مقدمه

در این جلسه با شما هستیم با آموزش نرم افزار ۲۰۱۸ PhpStorm که یکی از نرم افزار های حرفه ای در زمینه طراحی و توسعه وب سایت می باشد. پش با ما باشید با آموزش این نرم افزار محبوب و حرفه ای در سایت پی وی لرن 

راهنمای شروع سریع phpstorm

پیش از اینکه شروع کنید

PhpStorm یک محیط توسعه مجتمع برای توسعه دهندگان PHP است که بر روی پلت فرم IntelliJ IDEA ساخته شده است.

PhpStorm از چه زبان هایی پشتیبانی می کند؟

با PhpStorm، شما می توانید برنامه های کاربردی در نسخه های PHP 5.3، ۵٫۴، ۵٫۵، ۵٫۶، ۷٫۰، ۷٫۱ را توسعه دهید. علاوه بر این، به طور کامل HTML (از جمله ، CSS ،(HTML5، جاوا اسکریپت و XML را پشتیبانی می کند: این زبان ها از طریق پلاگین ها در IDE همراه هستند و به طور پیش فرض برای شما فعال می شوند. پشتیبانی از زبان های دیگر نیز می تواند از طریق پلاگین ها اضافه شود (در ویندوز و لینوکس به Settings | Appearance and Behavior | Plugins و در macOS به PhpStorm | Preferences | Appearance and Behavior | Plugins بروید) که برای پی بردن بیشتر یا تنظیم آنها در طی راه اندازی اولیه می باشد.

phpStorm روی چه سیستم عاملی می تواند اجرا شود؟

PhpStorm یک IDE با چند سیستم عامل است(cross-platform) که در ویندوز، macOS و لینوکس کار می کند.

سیستم مورد نیاز برای شروع با PhpStorm چیست؟

برای اجرای PhpStorm، نیاز به حداقل ۱ گیگابایت رم (۲ گیگابایت رم توصیه می شود)، رزولوشن صفحه نمایش حداقل ۱۰۲۴×۷۶۸، و نیازهای سیستم زیر:

توجه داشته باشید که JRE 1.8 همراه با توزیع برای همه سیستم عامل ها است. این به این معنی است که شما برای اجرای PhpStorm نیازی به جاوا ندارید تا بر روی دستگاه شما نصب شود.

جزئیات بیشتری در مورد نیاز های PhpStorm ببینبد در نصب و راه اندازی PhpStorm .

پیکربندی محیط PHP

با وجود اینکه PhpStorm یک IDE(محیط یکپارچه توسعه نرم افزار) هوشمند است، ابتدا شما باید از نوع محیط PHP که ما استفاده می کنیم، جایی که اجزای PHP ذخیره می شوند، و نحوه پیکربندی آنها آگاهی پیدا کنید.

اگر با یک سرور وب محلی کار می کنید، برای تهیه محیط خود از آموزش های زیر استفاده کنید:

• نصب و پیکربندی XAMPP با PhpStorm
• نصب و پیکربندی MAMP با PhpStorm

اگر در یک ظرف Docker container) Docker) مشغول به کار هستید، پشتیبانی Docker در PhpStorm را ببینید.

در این “راهنمای شروع سریع Phpstorm” ما یک پروژه از پیش پیکربندی شده را در یک نمونه Vagrant ایجاد خواهیم کرد. پیش از اینکه شروع کنید:

1. Oracle VirtualBox و Vagrant page  را از سایت های رسمی آنها دانلود و نصب کنید.
2. مسیر فایل اجرایی Vagrant را در صفحه Vagrant مشخص کنید (File | Settings | Tools | Vagrant برای ویندوز و لینوکس یا PhpStorm | Preferences | Tools | Vagrant برای macOS).

مرحله ۱: یک پروژه در PhpStorm باز کنید

همه چیزهایی که در PhpStorm انجام می دهید در قالب یک پروژه انجام می شود. این به عنوان پایه ای برای کمک های برنامه نویسی، کد بازسازی توده(bulk refactoring)، تطابق نوع کدگذاری(coding style consistency) و غیره بکار می رود.

در این راهنمای شروع سریع، ما یک پروژه کارگاهی از پیش تنظیم شده که در حال حاضر یک فایل Vagrantfile را شامل می شود، ارائه می دهیم. این پروژه در GitHub در اینجا موجود است.

برای باز کردن این پروژه در PhpStorm و تنظیم محیط Vagrant:

1. در صفحه خوش آمد گویی، گزینه Check out from Version Control را کلیک کرده و سپس GitHub را از لیست انتخاب کنید.
2. در کادر محاوره ای Clone Repository که باز می شود، https://github.com/JetBrains/phpstorm-workshop را در قسمت Git Repository URL تایپ کنید، سپس Parent Directory را برای پروژه انتخاب کنید. PhpStorm یک پوشه را برای پروژه به صورت خودکار ایجاد می کند، نام پیشنهاد شده در قسمت Directory Name نشان داده می شود.
3. PhpStorm پس از آنکه پروژه کلون شد پیشنهاد می کند که پروژه را باز کنید. پروژه را باز کنید و Directory Name را از منوی اصلی انتخاب کنید.

شما گزینه های دیگری برای شروع کار بر روی یک پروژه در PhpStorm دارید؛ همانطور که می توانید از صفحه Welcome ببینید:

مرحله ۲: رابط کاربری را بررسی کنید

پنجره اصلی PhpStorm به چند منطقه منطقی تقسیم شده است:

1. منوها و نوارهای ابزار که به ما کمک می کنند دستورات مختلف را اجرا کنیم.
2. نوار ناوبری(Navigation) برای مرور در پروژه.
3. نوار وضعیت با اطلاعات مختلف در مورد کل PhpStorm، پروژه فعلی یا یک فایل در ویرایشگر، هشدارها و پیام های خطا.
4. ویرایشگر جایی که در واقع شما کد خود را آنجا می نویسید. ویرایشگر زبانه هایی برای ناوبری آسان بین فایل های باز شده دارد.
5. ابزارهای متعدد ویندوز که عملکردهای مختلفی را انجام می دهند: به شما کمک می کند تا از طریق پروژه و ساختارهای فایل، مشاهده‌ی جستجو و نتایج بازرسی، اجرای برنامه ها، اشکال زدایی و تست برنامه‌ها، کار در کنسول های تعاملی و غیره، بررسی و ناوبری کنید.

مرحله ۳: کدنویسی با smart assistance

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

تکمیل کد(Code completion)

ت کمیل کد یک صرفه جوی عالی صرف نظر از نوع فایلی است که با آن کار می کنید. در PhpStorm دو نوع تکمیل کد وجود دارد: اساسی(basic) و هوشمند(smart) .

تکمیل اساسی (Ctrl + Space) گزینه های تکمیل کد را برای متن فعلی نشان می دهد و اعضای نوع فعلی را به صورت پررنگ نشان می دهد:

برای نمایش انواع بیشتر، Ctrl + Space را مجددا فشار دهید.

برای تکمیل کد اساسی، workshop/02_Editing/01_Completion/1.1_Basic_Completion.php را در پروژه خود باز کنید و دستورالعمل ها را در توضیحات دنبال کنید.

تکمیل هوشمند (Ctrl + Shift + Space) زمینه ای را که در حال حاضر در آن کار می کنید تجزیه و تحلیل می کند و پیشنهادات دقیق تر را بر اساس آن تجزیه و تحلیل پیشنهاد می کند و لیست توابع و متغیرها را برای مطابقت با نوع عبارت فیلتر می کند.

اقدامات احتمالی(Intention actions)

PhpStorm نگاهی به آنچه شما در حال حاضر انجام می دهید دارد و پیشنهاداتی هوشمندانه، به نام اقدامات احتمالی(Intention actions)، برای صرفه جویی بیشتر در وقت شما ارائه می دهد. اقدامات احتمالی به شما این امکان را می دهد که تغییرات خودکار را که درست هستند به کد اعمال نمایید (در مقایسه با بازبینی های کد که اصلاحات سریع را برای کد ارائه می دهند ممکن است نادرست باشد).

کد شما به فایلی که وجود ندارد مراجعه می کند؟

مشکلی با PhpStorm نیست. Alt + Enter را فشار دهید و <Create file <filename را انتخاب کنید: لیست کاملی از اقدامات احتمالی موجود را در File Settings | Editor | Intentions) Intentions برای ویندوز و لینوکس یا PhpStorm | Preferences | Editor | Intentions برای macOS) ببینید.

برای انجام اقدامات احتمالی مختلف، workshop/02_Editing/05_Intentions/5.1_Intentions.php را در پروژه خود باز کنید و دستورالعمل ها را در توضیحات دنبال کنید.

مرحله ۴: کد خود را مرتب نگه دارید

PhpStorm بر کد شما نظارت می کند و سعی می کند آن را دقیق و پاک نگه دارد. خطاهای احتمالی و مشکلات را شناسایی می کند و پیشنهاداتی برای رفع سریع آنها ارائه می دهد.

هر زمانی که PhpStorm کد بدون استفاده پیدا می کند، یک حلقه بی پایان، دامنه بالایی پنهان، یک اپراتور انتساب = در یک عبارت شرطی و بسیاری از چیزهای دیگر که احتمالا به توجه شما نیاز دارند، یک لامپ را خواهید دید. روی آن کلیک کنید یا Alt + Enter را فشار دهید، تا عملیات تصحیح اعمال شود.

یک عبارت use را فراموش کردید؟

Alt + Enter را فشار دهید و بر Import class کلیک نمایید.

در لیست، بر روی class to import کلیک کنید:

PhpStorm کلاس انتخاب شده را وارد می کند و یک عبارت use اضافه می کند:

مثالهای زنده بیشتر را در workshop/03_Inspections/02_Quick_Fixes.php ببینید.
لیست کاملی از بازرسی های موجود در صفحه بازرسی ها “Inspections page” را ببینید(Settings | Editor | Inspections برای ویندوز و لینوکس یا PhpStorm | Preferences | Editor | Inspections برای macOS) . شما می توانید برخی از آنها را غیرفعال کنید یا برخی دیگر را فعال کنید و همچنین می توانید دقت هر بازرسی را تنظیم کنید. شما تصمیم می گیرید که آیا باید یک خطا یا یک هشدار در نظر گرفته شود.

مرحله ۵: تعدادی کد ایجاد کنید

کد نویسی می تواند بسیار ساده تر و سریع تر با گزینه های code generation  موجود در PhpStorm باشد. منوی The Code | Generate (یا Alt + Insert) به شما در ساختار های تولید، گیرنده ها یا تنظیم کننده ها، کامنت های PHPDoc کمک می کند و همچنین نادیده گرفتن یا پیاده سازی برخی از روش ها (Ctrl + O یا Ctrl + I) را پیشنهاد می کند:

مثالهای زنده بیشتر را در workshop/02_Editing/06_Generate_code/6.1_Generate_Code.php ببینید.
از قالب های زنده استفاده کنید(Code | Insert Live Template را انتخاب کنید یا Ctrl + J را فشار دهید) تا تمام ساختمان کد تولید شود. لیستی از قالب های زنده و آماده برای استفاده را در صفحه Live Templates مشاهده کنید(File | Settings | Editor | Live templates برای ویندوز و لینوکس یا PhpStorm | Preferences | Editor | Templates برای macOS). اگر متوجه شدید چیزی واقعا مهم برای توسعه خود نیاز دارید، این مجموعه قالب ها را با یکی های خودتان گسترش دهید.

مثال های زنده را در workshop/04_Live_Templates/01_Code_Expansion/1.1_Code_Expansion.php و workshop/04_Live_Templates/02_Creating_Live_Templates امتحان کنید.

همچنین، در نظر داشته باشید که کد خود را با ساختار های کامل محصور نمایید. Code | Surround With را انتخاب کنید یا کلید ترکیبی Ctrl + Alt + T را فشار دهید و سپس عبارت مورد نظر را از لیست پاپ آپ(pop-up) انتخاب کنید:

مثال های زنده بیشتر را در workshop/04_Live_Templates/03_Surround_Templates/3.1_Simple_template.php امتحان نمایید.

مرحله ۶: راه خود را از این طریق پیدا کنید

هنگامی که پروژه شما بزرگ است یا زمانی که شما باید با کد نوشته شده توسط شخص دیگری کار کنید، بسیار مهم است که بتوانید به سرعت آنچه را که دنبال می کنید پیدا کنید و به کد وارد شوید. به همین دلیل PhpStorm همراه با مجموعه ای از ویژگی های ناوبری به کمک شما آمده است تا راه خود را از طریق هر کد بدون توجه به چگونگی پیچیدگی آن پیدا کنید.

جستجوی اساسی

برای پیدا کردن محلی که یک نماد خاص در پروژه شما مورد استفاده قرار گرفته است، PhpStorm یک جستجوی کامل را از طریق Alt + F7) Find Usages) پیشنهاد می کند:

شما همچنین می توانید تنها در فایل فعلی (Ctrl + F) یا در داخل یک پوشه، هر دامنه دلخواه یا کل پروژه (Ctrl + Shift + F) جستجو کنید.

برای انجام جستجوی اساسی workshop/01_Navigation/05_Find_usages/5.2_Find_Usages.php یا workshop/01_Navigation/05_Find_usages/5.1_Highlight_Usages_in_File را در پروژه خود باز نمایید و دستورالعملها را در کامنت ها دنبال کنید.

ناوبری پروژه “Project navigation”

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

• جستجو در همه جا “Search Everywhere” به شما امکان می دهد تا کلاس ها، فایل ها، نمادها و اقدامات منو را همه را در یک زمان جستجو کنید و همچنین به آنها مراجعه کنید. برای راه اندازی Search Everywhere، روی نماد  در گوشه سمت راست بالای پنجره PhpStorm کلیک کنید یا دو بار Shift را فشار دهید. اگر شما الگوی جستجو را مشخص نکنید(چیزی تایپ نکنید)، PhpStorm تنها لیستی از فایل های اخیر را نشان می دهد که می توانید با کلیک کردن بر روی آیتم مربوطه حرکت کنید:

برای جستجوی چیزی خاص، عبارت جستجو را تایپ کنید. توجه داشته باشید که علاوه بر نمادها، Search Everywhere می تواند عملیات را نیز پیدا کند:

در حالت  PhpStorm ،Search Everywhere حتی CamelHumps را می پذیرد و تطبیق های میانی را به رسمیت می شناسد.

برای امتحان کردن روش های مختلف استفاده از Search Everywhere، workshop/01_Navigation/01_Navigate_to_something_you_know/1.6_Search_everywhere.md را در پروژه خود باز کنید و دستورالعمل ها را دنبال کنید.

مطمئنا ناوبری به یک کلاس (Ctrl + N)، یک فایل (Ctrl + Shift + N) یا نماد (Ctrl + Shift + Alt + N) توسط نام آن نیز در اختیار شما قرار می گیرد.

Go To Declaration یا رفتن به اعلان (Ctrl+B و Ctrl+Click برای ویندوز و لینوکس یا Click+⌘ برای macOS) شما را به محلی می برد که نماد خاصی برای اولین بار اعلام شده است. این نوع ناوبری از هر مکان در کد منبع، حتی از یک کلاس یا کامنت دیگر کار می کند.

برای انجام ناوبری بروید به اعلان(Declaration) و workshop/01_Navigation/02_Navigate_to_Declaration/2.1_Go_to_declaration.php را در پروژه خود باز کنید و دستورالعمل ها را در کامنت ها دنبال کنید.

Go to Implementation یا رفتن به پیاده سازی (Ctrl + Alt + B) شما را به پیاده سازی یک کلاس خاص می برد. اگر پیاده سازی های متعددی وجود داشته باشد، PhpStorm آنها را در یک لیست نشان می دهد که در آن شما می توانید گزینه مورد نظر را برای حرکت انتخاب کنبد:

برای امتحان navigating through به Go to Implementation بروید و workshop/01_Navigation/04_Navigate_class_hieracrhies/4.1_Go_to_Implementation.php را در پروژه خود باز کنید و دستورالعمل ها را در کامنت ها دنبال کنید.

حرکت از طریق جدول زمانی یا timeline

PhpStorm به طور خودکار تغییراتی را که شما در کد منبع، نتایج بازسازی و غیره در تاریخ محلی ایجاد می کنید، پیگیری می کند. برخلاف سیستم های کنترل نسخه های سنتی، تاریخ محلی همیشه فعال است. برای دیدن آن برای یک فایل یا یک پوشه، VCS | Local History | Show History را در منوی اصلی انتخاب نمایید. در اینجا شما می توانید تغییرات را بررسی کنید، آنها را بازگردانید، یا یک مسیر ایجاد کنید:

برای امتحان استفاده از تاریخ محلی خودتان workshop/09_Version_Control/07_Local_History.php را در پروژه خود باز نموده و دستورالعملها را دنبال کنید.

مرحله ۷: باگ برنامه خود را برطرف کنید

آیا برنامه شما دقیقا همان چیزی که در نظر گرفته شده است را انجام می دهد؟ اگر آن طور کار نمی کند، باید برخی از اشکال زدایی ها را انجام دهید تا متوجه شوید مشکل چیست. خوشبختانه، در پروژه نمونه ما از قبل Xdebug نصب و پیکربندی شده است.

پیکربندی مترجم PHP

در پروژه ما، جعبه Vagrant در حال حاضر شامل مترجم php است و شما فقط باید محل آن را به PhpStorm بگویید.

1. صفحه PHP را باز کنید (Settings | Languages and Frameworks | PHP برای ویندوز و لینوکس یا PhpStorm | Preferences | Languages and Frameworks | PHP برای macOS) و بر روی  در کنار فیلد مترجم CLI کلیک کنید.
2. در کادر محاوره‌ای CLI Interpreters باز شده، بر روی  در سمت چپ کلیک کنید و  …From Docker, Vagrant, VM, Remote را از لیست انتخاب کنبد.
3. در کادر محاوره‌ای Configure PHP Remote Interpreter باز شده، Vagrant را انتخاب کنید. PhpStorm مترجم php را شناسایی می کند و شما را به کادر محاوره‌ای CLI Interpreters منتقل می کند که در آن نسخه های مترجم شناسایی شده و Xdebug نمایش داده می شوند. همش همین بود -حالا فقط روی OK کلیک کنید.

نقطه توقف(Breakpoints) را تنظیم کنید

اشکال زدایی با قرار دادن نقطه های توقف که در آن اجرای برنامه به حالت تعلیق درآمده، شروع می شود، بنابراین می توانید داده های برنامه را بررسی کنید. فقط روی زاویه سمت چپ خط که در آن می خواهید نقطه توقف ظاهر شود، کلیک کنید:

برای کار با نقاط توقف workshop/06_Debugging/03_Breakpoints.php را در پروژه خود باز نموده و دستورالعمل های موجود در کامنت ها رو دنبال کنید.

شروع اشکالزدایی یا debugging

در پنجره ابزار پروژه workshop/06_Debugging/03_Breakpoints.php را انتخاب کنید و Debug 03_Breakpoints.php را در منوی زمینه انتخاب کنید:

PhpStorm یک دوره اشکال زدایی را شروع می کند و پنجره Debug Tool را باز می کند که در آن می توانید از طریق برنامه‌ی معلق، مقادیر متغیرها، ارزیابی عبارات و خیلی چیزهای دیگر گام بردارید. مثالهای زنده بیشتر را در workshop/06_Debugging/05_Debug_Tool_Window.php امتحان کنید.

مرحله ۸: کد خود را تست کنید

PhpStorm با محبوب ترین چارچوب های تست PHP پیاده سازی شده است: مانند PHPUnit، Behat، PHPSpec و Codeception.

تست های خود را بنویسید

حفچ
ض۵ش

در کادر محاوره ای باز شده، تمام فیلدها پر می شوند، پس فقط روی OK کلیک کنید. PhpStorm یک کلاس تست <class_to_test>Test را ایجاد می کند و آن را در ویرایشگر باز می کند. تست های خود را در صورت نیاز بنویسید.
برای نوشتن تست ها به کمک برنامه نویسی PhpStorm توسط خودتان ، workshop/08_Testing/01_Writing_Tests.php را باز کنید و دستورالعمل ها را در کامنت ها دنبال کنید.

تست را شروع کنید

فایل را با تست های خود در ویرایشگر باز کنید یا روی آن در پنجره ابزار پروژه کلیک کنید و Run <class_to_test> Test را انتخاب کنید. این پیکربندی  PHPUnit Run را اجرا می کند که PhpStorm به صورت خودکار برای شما ایجاد می کند. شما همچنین می توانید یک تنظیمات run از نوع Behat، PHPSpec یا Codeception ایجاد کنید(Run | Edit Configurations)، آن را از لیست کشویی نوار ابزار انتخاب کنید و سپس روی  کلیک کنید. PhpStorm نتایج را در Test Runner Tab در پنجره Run Tool نشان می دهد.

مرحله ۹: کد منبع خود را تحت کنترل نسخه “Version Control” نگه دارید

اگر شما کد منبع خود را تحت کنترل نسخه نگه دارید، خوشحال خواهید شد که PhpStorm با بسیاری از سیستم های کنترل نسخه‌ی محبوب Git یا Subversion ،TFS ،Perforce ،Mercurial ،GitHub و CVS ادغام شده است. برای تعیین اعتبار و هر تنظیمات خاص برای یک VCS خاص، به کنترل نسخه (Settings | Version Control برای ویندوز و لینوکس یا PhpStorm | Preferences | Version Control برای macOS) بروید.

منوی VCS به شما یک سرنخ می دهد که چه دستوراتی در دسترس است. به عنوان مثال، شما می توانید تغییراتی که ایجاد کرده اید، لیست تغییرات ایجاد شده و خیلی بیشتر را از نمایش پاپ آپ تغییرات (Show Changes View << VCS  یا  Alt + 9) ببینید.

مرحله ۱۰: همینه! برو جلو و با لذت پیشرفت کن

ما امیدواریم که این مرور کلی از ویژگی های ضروری PhpStorm به شما امکان یک شروع سریع را بدهد. ویژگی های مهم بسیاری وجود دارد که زندگی یک توسعه دهنده را ساده تر و سرگرم کننده تر و کد منبع آنان را مرتب تر و خواناتر می کند. این چند مرحله اول را در حال حاضر دنبال کنید و بکار گیرید، و در زمان مناسب عمیق تر و حرفه ای تر کار کنید. از PhpStorm لذت ببرید!