Skip to content

Latest commit

 

History

History
102 lines (71 loc) · 3.87 KB

new_project_git.rst

File metadata and controls

102 lines (71 loc) · 3.87 KB
.. index::
   single: Set Up; Git

How to Create and Store a Symfony Project in Git

Tip

Though this entry is specifically about Git, the same generic principles will apply if you're storing your project in Subversion.

Once you've read through :doc:`/page_creation` and become familiar with using Symfony, you'll no-doubt be ready to start your own project. In this article, you'll learn the best way to start a new Symfony project that's stored using the Git source control management system.

Initial Project Setup

To get started, you'll need to download Symfony and get things running. See the :doc:`/setup` article for details.

Once your project is running, just follow these simple steps:

  1. Initialize your Git repository:

    $ git init

  2. Add all of the initial files to Git:

    $ git add .

    Tip

    As you might have noticed, not all files that were downloaded by Composer in step 1, have been staged for commit by Git. Certain files and folders, such as the project's dependencies (which are managed by Composer), parameters.yml (which contains sensitive information such as database credentials), log and cache files and dumped assets (which are created automatically by your project), should not be committed in Git. To help you prevent committing those files and folders by accident, the Standard Distribution comes with a file called .gitignore, which contains a list of files and folders that Git should ignore.

    Tip

    You may also want to create a .gitignore file that can be used system-wide. This allows you to exclude files/folders for all your projects that are created by your IDE or operating system. For details, see GitHub .gitignore.

  3. Create an initial commit with your started project:

    $ git commit -m "Initial commit"

At this point, you have a fully-functional Symfony project that's correctly committed to Git. You can immediately begin development, committing the new changes to your Git repository.

You can continue to follow along with the :doc:`/page_creation` article to learn more about how to configure and develop inside your application.

Tip

The Symfony Standard Edition comes with some example functionality. To remove the sample code, follow the instructions in the ":doc:`/bundles/remove`" article.

Storing your Project on a remote Server

You now have a fully-functional Symfony project stored in Git. However, in most cases, you'll also want to store your project on a remote server both for backup purposes, and so that other developers can collaborate on the project.

The easiest way to store your project on a remote server is via a web-based hosting service like GitHub or Bitbucket. Of course, there are more services out there, you can start your research with a comparison of hosting services.

Alternatively, you can store your Git repository on any server by creating a barebones repository and then pushing to it. One library that helps manage this is Gitolite.