Best practices when making a Yii2 Extension

What is the best way to create a extension for Yii2?

How to register the extension with the application and how to organize views, controllers and models within the extension?

 

You can follow each step below to help you set-up your first Yii2 extension:

1. Github setup

Create a new github repo and make sure to follow the naming conventions for yii2-extensions like this:

ourcompany/yii2-ourextension

ourcompany being our github-scope and ourextension the name of our extension.

 

2. Local project setup

Create a local folder where you will develop the extension. First create a file composer.json. This folder should not be in the vendor-folder of an existing project! It won't work any other way, except to declare a namespaces within autoload.php of surrounding project manually.

composer.json

The most important things to remember:

  • The dependencies (usually the Yii2-framework)
  • Autoload-property which declares the namespace for package. This will later be used by yiis-autoloader to find classes.

After that, run composer update this will create the vendor folder containing all referenced libraries.

Here is an example of composer: https://github.com/asinfotrack/yii2-toolbox/blob/master/composer.json

Pay special attention to the autoload block at the end of the file! In this case autoloader that asinfotrack/yii2/toolbox will be mapped to the root-folder of the project. Folder models with class in your project root should have the namespace asinfotrack/yii2/toolbox/models.

.gitignore

The next to create .gitignore-file. Exclude the vendor-folder and all IDE files.

Also an example of the same extension mentioned above. Simply copy/paste it: https://github.com/asinfotrack/yii2-toolbox/blob/master/.gitignore

Git-repo-setup

Now initialize the git-repo, simply navigate to directory and execute the command git init. To add all files and commit for the first time, execute git add -A and git commit -m "message here". Now you are ready to push repo to github.

Need to set the remote of repo to github. This is done with the following command:

git remote add origin https://github.com/ouraccount/ourrepo.git

Also make sure that the following config vars are set correctly:

git config user.email git config user.name

The email should match with your github-account email. If you want to change the values, simply append them to the commands above. Like below:

git config user.email "my-mail@my-domain.com"

Now we need to push the extension to github:

git push origin master

 

3. Packagist-setup

For other users to be able to reference our extension within their projects, we need to register it with packagist.org.

Create an account and submit extension as explained here: https://packagist.org/packages/submit

 

4. Connecting packagist and github

Packagist mirrors repo for further distribution. Enabling the Packagist service hook ensures that your package will always be updated instantly when you push to GitHub.

Go to the settings of github-repo and navigate to Webhooks & Services. Then add a new hook for packagist. This is supported natively by github. Find the packagist-hook in the dropdown.

We need to provide packagist-API-Token which we can find on the top of account-page when logged into packagist.org. Everything is documented very well here:

https://packagist.org/about

 

5. Conclusion

That's it! When performing a new commit to github, it will be mirrored automatically to packagist. With a few minutes delay we will receive the updated version of our extension when we execute composer update.

At first all of this might look intimidating and complicated, but actually it's pretty straight forward.

 



Was this article helpful?

Top Related Jobs

Top Freelance jobs are waiting for you, View & apply to earn more.

  • YII Framework

    $6,000, Fixed | India
    I have 1 site which is almost completed but there is some changes which i need to be done within 2weeks so thats:


People also searched for

How to post a Job & Hire a great WordPress developer
How to post a Job & Hire a great WordPress develop...
Web Development

WordPress is an open source Content Management System (CMS), which allows the users to build dynamic websites and blog. WordPress is the most popular blogging system on the web and...

Read More
Some Useful JavaScript Tips,Tricks and Best Practices
Some Useful JavaScript Tips,Tricks and Best Practi...
Web Development

As you know, JavaScript is the top programming language in the world, the language of the web, of mobile hybrid apps (like PhoneGap or Appcelerator), of the server side (like NodeJ...

Read More
How to Write a Job Description to Find a Good PHP Developer?
How to Write a Job Description to Find a Good PHP...
Web Development

PHP (recursive acronym for PHP: Hypertext Pre-processor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be em...

Read More

You are freelancing Ninja?

Try Auto proposal today, The new virtual assistant for your freelancing world.