Мануал phpStorm на русском


Руководство пользователя PhpStorm на русском языке
Найти на сайте: параметры поиска

Импорт проекта из существующего кода

10 декабря 2013 — Администратор

Вы можете создать проект из существующего исходного кода, который был создан в другой IDE или другом редакторе. PhpStorm анализирует существующий код, добавляет каталог .idea с настройками, и обозначает проект специальным значком

.

Если рабочие файлы уже находятся на вашем компьютере, вы можете настроить среду разработки следующими тремя способами:

  • На вашем компьютере установлен локальный Web-сервер, исходные файлы могут находится в корневой паке сервера (напрмер /htdocs), и вы запускаете свой проект на локальном сервере.
  • На вашем компьютере установлен локальный Web-сервер, но исходные файлы находятся в другой папке или на другом диске. Разрабатываемый проект должен быть синхронизирован с сервером.
  • На вашем компьютере не установлен локальный Web-сервер или вы не собираетесь им пользоваться. Исходные файлы находятся на вашем компьютере, вы просто делаете свою разработку, возможно, с помощью консоли, чтобы посмотреть выходной код.

Наконец, вам, возможно, потребуется изменить проект на удаленном хосте. В этом случае вам придется загрузить исходные файлы на свою машину и создать проект, поскольку PhpStorm не поддерживает редактирование файлов на удаленном хосте. Редактирование, отладка и тестирование проекта производятся на локальной машине, а затем готовое приложение заливается по месту назначения.

Для получения дополнительной информации см. в разделе Работа с веб-сервером и Создание проекта из скачанных файлов.

Создание проекта из существующих локальных исходников

Когда рабочие файлы уже находятся на вашем компьютере, вы можете настроить среду разработки следующими способами:

1. На вашем компьютере не установлен Web-сервер или вы не собираетесь его использовать. Исходные файлы находятся на вашем компьютере, вы просто делаете свою разработку, возможно, с помощью консоли, чтобы посмотреть выходной код. В этом случае, вы можете просто открыть папку, в которой хранятся исходные файлы, без настройки доступа к серверу. Тем не менее, вы также можете использовать мастер New Project.

2. На вашем компьютере Web-сервер установлен, источники находятся в корневой папке сервера (например, / htdocs), и вы делаете разработку прямо на сервере. В этом случае вам нужно использовать мастер New Project, чтобы организовать исходные файлы в проект, назначить корневую папку проекта, и настроить доступ к серверу через настройки.

3. На вашем компьютере Web-сервер установлен , но источники хранятся в другой папку или на другом диске. Вы выполняете свою разработку, а затем синхронизируете файлы с сервером. Используйте мастер New Project, чтобы организовать исходные файлы в проект , назначить корневую папку проекта, настроить доступ к серверу через конфигурации типа местного доступа сервера и отобразить папки в корневой папке проекта с папками на сервере.

Создание проекта без локального сервера, из папки с исходными файлами

Если вы не собираетесь использовать веб-сервер, вы можете просто открыть папку с файлами, которые будут расположены в проекте PhpStorm.

1. В главном меню выберите File | Open Directory.

2. В открывшемся диалоговом окне выберите каталог, содержащий необходимые файлы с исходным кодом. Обратите внимание, что приложения, созданные извне, помечены значком регулярного каталога

.

3. Нажмите кнопку ОК и укажите, нужно ли создать новый проект, который будет открыт в отдельном окне или закрыть текущий проект и повторно использовать уже существующий. За подробностями обратитесь к разделу Открытие нескольких проектов.

Создание проекта без локального сервера, из папки с исходными файлами, с помощью мастера New Project

Еще один способ организовать исходные файлы в проекте PhpStorm — это использовать мастер создания проекта New Project.

1. Запустите мастер New Project, выбрав в главном меню команду New Project from Existing Files.

2. На странице Choose Your Scenario выберите Source files are in a local directory, no Web server is yet configured и нажмите Next.

3. На странице Choose Project Directory выберите папку, в которой хранятся источники и нажмите на иконку

на панели инструментов. Или выбрать Project Root в контекстном меню выбора назначить корневой папке проекта (project root). PhpStorm отмечает выбранную папку значком

.

4. Настройте коренную папку проекта. Вы можете сделать это позже, на странице Directories в Настройках.

5. Нажмите кнопку Finish и укажите, нужно ли создать новый проект, который будет открыт в отдельном окне или закрыть текущий проект и повторно использовать уже существующий. За подробностями обратитесь к разделу Открытие нескольких проектов.

Создание проекта из существующих источников в корне локального сервера.

В этом случае, вам нужно использовать мастер создания проекта New Project , расположить исходные файлы в проекте, назначить корневую папку проекта, и настроить доступ к серверу.

1. Чтобы запустить мастер создания проекта, выберите команду New Project from Existing Files в главном меню.

2. На странице Choose Your Scenario выберите Web server is installed locally, source files are located under its document root и нажмите Next.

3. На странице Choose Project Directory выберите папку, в которой хранятся источники и нажмите на иконку

на панели инструментов или выберите Project Root в контекстном меню выбора и назначьте project root проекта. PhpStorm отмечает выбранную папку значком

.

4. Настройте папку, которая будет корнем проекта. Вы можете сделать это и позже, на странице Directories в Настройках. Нажмите Next.

5. На странице Specify Local Server настроить доступ к серверу. Подробнее об этом читайте статью "Настройка синхронизации с веб-сервером" . Выполните одно из следующих действий:

  • Выберите Use existing server и определите соответствующие настройки сервера из списка. Этот список содержит только настройки типа In-place, отмеченные значком

    , поскольку ваши файлы уже находятся в корне сервера.

  • Выберите Add new local server, щелкните Next, а затем на открывшейся странице Add Local Server определите необходимые настройки доступа к серверу.

1. Укажите имя конфигурации сервера в текстовом поле Name. PhpStorm самостоятельно задает тип конфигурации In-place.

2. В текстовом поле Web server root URL, введите URL-адрес, связанный с корневой папкой веб-сервера, как это определено в файле конфигурации веб-сервера. Этот адрес URL будет отправной точкой для построения URL-адреса вашего приложения. Поддерживаются протоколы HTTP и HTTPS.

Пример. Для httpd-сервера Apache конфигурационным файлом является httpd.conf. По умолчанию корневая папка находится в папке htdocs, а доступ к данным осуществляется по URL-адресу http://localhost. Если вы изменили 80 порт, используемый по умолчанию, на другой, вы должны набрать адрес http://localhost:<port>.

Нажмите Next.

3. На странице Specify Web Path укажите адрес URL для доступа к вашей корневой папке проекта. В текстовом поле Web path for project root введите путь к корневой папке проекта по отношению к корню сервера, указанного в файле конфигурации сервера. По мере ввода PhpStorm динамически строит адрес URL и показывает его как ссылку в поле Project URL. Для проверки того, что адрес URL создался правильно и обеспечивает доступ к корню проекта, нажмите на ссылку.

Для получения дополнительной информации читайте статью Creating an In-Place Server Configuration.

6. Нажмите кнопку Finish и укажите, желаете ли вы создать новый проект, который будет открыт в отдельном окне или завершить работу мастера и открыть созданный проект. Более подробно читайте статью "Открытие нескольких проектов".

Создание проекта из источников за пределами корня сервера.

В данном случае вам нужно использовать мастер New Project для указания исходных файлов проекта, назначить корневую папку проекта, и настроить доступ к серверу.

1. Запустите мастер New Project, выбрав в главном меню New Project from Existing Files.

2. На странице Choose Your Scenario выберите Web server is installed locally, source files are located elsewhere locally и нажмите Next.

3. На странице Specify Local Path, назначить корень проекта. Укажите папку, где хранятся источники и где будет создан проект.

4. На странице Specify Server назначить конфигурацию доступа к серверу для того, чтобы обеспечить доступ к серверу. Для получения дополнительной информации см. "Настройка синхронизации с веб-сервером". Выполните одно из следующих действий:

4.1 Выберите Use existing server и выберите соответствующие настройки сервера из списка. Список содержит только конфигурации типа Local, помеченные иконкой

. Поскольку ваши файлы хранятся локально на вашем компьютере, но не в корне документа сервера, конфигурация типа In-place не будет соответствовать действительности.

4.2 Выберите Add new local server, нажмите кнопку click Next, и в открывшемся окне Add Server определите конфигурацию доступа к серверу:

4.2.1. Укажите имя конфигурации сервера в текстовом поле Name. PhpStorm автоматически определит тип конфигурации Local.

4.2.2. В поле Folder, в зоне Upload/download project files определите корневую папку конфигурации сервера (server configuration root). Эта папка, server configuration root, является самой верхней папкой в дереве файлов на сервере, доступном через конфигурации сервера. Самый простой способ состоит в использовании корня документов веб-сервера, как это определено в файле конфигурации веб-сервера. Однако, вы можете назначить любую другую существующую папку в корневом каталоге документов.

4.2.3. В текстовом окне Web server root URL, в зоне Browse files on server укажите URL-адрес корневую папку конфигураций сервера. Этот адрес URL будет отправной точкой для построения URL-адресов вашего приложения. В зависимости от вашего выбора конфигурации корневых серверов, выполните одно из следующих действий:

4.2.3.1. Введите адрес URL, связанный с корневом каталоге документов (document root) веб-сервера, как это определено в файле конфигурации веб-сервера.

4.2.3.2. Введите адрес URL в формате <URL document root на сервере>/<путь к существующей папке с исходниками относительно document root>.

Нажмите Next.

За более подробной информацией обратитесь к статье Creating a Local Server Configuration

5. На странице Choose Remote Path создать папку на сервере, в которую PhpStorm будет загружать файлы проекта. Эта папка называется корень проекта на сервере (project root on the server), и она будет автоматически отображаться в корне проекта (project root).

Страница показывает дерево папок в кореной папке конфигурации сервера (server configuration root). Выберите соответствующую родительскую папку и выберите Create Folder в контекстном меню. Когда появится новая папка в дереве, выберите ее и нажмите на иконку

на панели инструментов или выбрать Project Root в контекстном меню. PhpStorm отмечает выбранную папку значком

.

Настройте папки в корне проекта. Кроме того, вы можете сделать это позже, на странице Directories диалогового окна настроек. Нажмите кнопку Next.

6. На странице Specify Web Path укажите адрес URL для доступа к вашей корневой папки проекта на сервере (project root folder on the server), которую вы назначили в предыдущем шаге. В поле Web path for project root введите путь к папке по отношению к кореной папке конфигурации сервера (server configuration root). Можно ввести относительный путь к корню проекта на сервере (project root on the server). По мере ввода PhpStorm динамически строит адрес URL и показывает его в поле Project URL.

Настройка папки в корне проекта.

В PhpStorm можно выбирать между исходными папками (Source), корневыми папками ресурсов (Resource Root) и папками исключений (Excluded ). По умолчанию любая папка рассматривается как исходная (Source) папка, если тип файлов в этой папке не ассоциирован с другим типом.

Вам также может понадобиться запретить выгружать / загружать файлы и папки. Запрет загрузки, выгрузки и синхронизации файлов или папок с источниками обеспечивает защиту от случайного обновления. Когда запрет применяется к файлам и папкам, отличным от Source , он позволяет сэкономить трафик, поскольку огромное количество картинок, скрытых или временных файлов больше не копируются туда-сюда.

Выберите каталог, который вы хотите промаркировать и выполните одно из следующих действий:

  • Чтобы заставить PhpStorm игнорировать выбранный каталог для индексации, анализа, завершение кода и т.д., нажмите кнопку

    на панели инструментов Excluded from Indexing, или выберите Excluded в контекстном меню.

  • Чтобы разрешить PhpStorm завершать относительные пути к ресурсам в выбранной папке, нажмите кнопку

    на панели инструментов или выберите Resource Root в контекстном меню.

  • Для запрещения загрузки, выгрузки и синхронизации для выбранной папки, щелкните значок

    или выберите Exclude Path в контекстном меню.

Более подробную информацию ищите в статьях Configuring folders under content roots и Excluding Files and Folders from Upload/Download.

Создание проекта из загруженных файлов

Время от времени вам необходимо подключаться через протоколы FTP/SFTP/FTPS к файлам, расположенных на удаленном хосте, сетевом ресурсе или диске. PhpStorm не поддерживает прямое редактирование файлов на удаленных хостах. Поэтому для работы с удаленными источниками, необходимо загрузить и организовать их в проекте PhpStorm. Чтобы обновить свои локальные и удаленные источники либо совместно синхронизировать их, Вы можете настроить автоматическую загрузку измененных файлов в диалоговом окне Options, используя выпадающий список Upload changed files automatically to the default server.

PhpStorm взаимодействует с удаленным хостом, где расположены файлы, используя настройки доступа к серверу (server access configuration). Вы можете использовать существующую настройку или определить новую при создании проекта.

Создание проекта PhpStorm из файлов с удаленного хоста, сетевого ресурса или примонтированного диска.

1. Запустите мастер New Project, выберите в главном меню New Project from Existing Files.

2. На странице странице мастера Choose Your Scenario, укажите способ доступа к файлам. Выполните одно из следующих действий:

  • Чтобы разрешить PhpStorm загружать удаленные файлы через сеть или с примонтированного диска, выберите Web server is on a remote host, files are accessible via network share or mounted drive.
  • Чтобы разрешить PhpStorm скачивать удаленных файлов через FTP, FTPS, или SFTP протоколы, выберите My web server is on a remote host, files are accessible via FTP/SFTP/FTPS.

Нажмите Next.

3. На второй странице мастера Specify Local Path укажите будущее местоположение проекта на вашем локальном компьютере и выберите необходимую стратегию скачивания:

3.1. Назначить родительскую папку, где будет расположен проект. Введите путь к нему вручную в текстовом поле Project local path или нажмите кнопку

и выберите нужное место в открывшемся диалоговом окне Select Path.

3.2 Укажите имя проекта в поле Project name. По мере ввода имя добавляется в пути проекта.

3.3. Выберите стратегию скачивания в поле Deployment options:

  • Чтобы разрешить PhpStorm скачать файлы с параметрами, заданными на странице Deploymen в диалоговом окне Setting, выберите опцию Default.
  • Чтобы изменить параметры по умолчанию, выберите параметр Custom и изменить настройки в диалоговом окне Create New Project: Review Deployment Options, которое откроется после нажатия кнопки Next.

3.4. Нажмите Next.

4. На странице Add Remote Server создайте конфигурацию доступа к серверу, чтобы включить взаимодействие между PhpStorm и удаленным хостом (либо примонтированым диском), на котором расположены файлы. Если у вас уже есть по крайней мере одна конфигурация доступа к серверу, PhpStorm откроет страницу Specify Remote Server. Просто пропустите этот шаг.

5. На странице Specify Remote Server настройте конфигурацию доступа к удаленному серверу (server access configuration), с которым PhpStorm будут взаимодействовать. Выполните одно из следующих действий:

  • Чтобы использовать существующую конфигурацию, нажмите кнопку Use existing server и выберите конфигурацию из списка. В списке показаны основные параметры доступа.
  • Чтобы определить новую конфигурацию, щелкните кнопку Add new remote server и создайте новую конфигурацию, как описано в предыдущем шаге. Диалоговое окно Add Remote Server откроется, после нажатия кнопки Next.

На странице Choose Remote Path, настроить структуру проекта, который будет создан.

Страница показывает папки в виде дерева относительно папки корневой конфигурации сервера.

1. Указать, какие удаленные папки находятся в корень проекта. Выберите соответствующую папку и щелкните значок

на панели инструментов или выберите Project Root в контекстном меню. PhpStorm отмечает выбранную папку значком

.

2. Вне корня проекта укажите папки, которые вам не нужно загружать по некоторым причинам. Это могут быть файлы-источники, которые вы не хотите обновлять вообще, медиа-файлы, картинки, кэши, временные файлы — все, что на самом деле не нужно в вашей работе. Выберите соответствующую папку и нажмите

или выберите Exclude Path в контекстном меню.

Важно. Исключение применяется рекурсивно. Это означает, что если выбранная папка содержит вложенные папки, они автоматически также помечаются как исключеные из проекта.

3. Настройте папки в корне проекта. По умолчанию, все файлы в этой папке рассматриваются как источники и участвуют в индексировании, поиске, анализе, автозавершении кода и т.д. Чтобы изменить этот статус, папки могут быть отнесены к следующим категориям:

  • Чтобы разрешить PhpStorm завершать относительные пути к ресурсам в выбранной папке, нажмите кнопку

    на панели инструментов или выберите Resource Root в контекстном меню.

  • Чтобы заставить PhpStorm игнорировать выбранный каталог для индексации, анализа, завершение кода и т.д., нажмите кнопку

    на панели инструментов или Excluded в контекстном меню.

Для возврата папке для ее обычного статуса, выберите папку в списке папок в корне, и нажмите кнопку

. Также можно выбрать папку в дереве корня и нажать на значок статуса еще раз.

Для получения дополнительной информации читайте статьи Configuring folders under content roots и Excluding Files and Folders from Upload/Download.

Комментарии (0)

Нет комментариев. Ваш будет первым!

Новые объявления

Нет объявлений для отображения.

Наши партнеры

Русский город — Не заблудись в родной стране! Справочники городов России

http://stormrus.ru/phpstorm/rukovodstvo-phpstorm/sozdanie-proektov-i-upravlenie-imi/import-proekta-iz-suschestvuyuschego-kod.html

Губарь Маргарита Александровна