conquerorsoft/my_first_project

Project created with composer init

Saturday, November 11, 2017
by gabriel0702
Repository
1 Watchers
0 Stars
7 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
13 Versions
0 % Grown

The README.md

My First Project

![Build Status][ico-travis] ![Quality Score][ico-code-quality] , _(*1)

This is my very first project I created at php[world]. I learned that I have to create a README file to provide a description of my project so it can be used by other projects or persons., _(*2)

The steps to create "my first project"

1- create the my_first_project directory, _(*3)

cd ~ && mkdir -p phplibrary/my_first_project && cd phplibrary/my_first_project

2- create a README.md file, _(*4)

vim README.md

3- initialize a git repository, _(*5)

git init

4- Do the first commit, _(*6)

git add .
git commit -m "First commit of my project"

5- Assign a version to your project, _(*7)

git tag -a v0.1.0 -m "version 0.1.0"

6- Create a repository in github or bitbucket 7- Connect your repository with github (or bitbucket), _(*8)

git remote add origin https://github.com/ConquerorSoft/my_first_project.git
git push -u origin master
git push origin v0.1.0

8- run composer init, _(*9)

composer init

9- enter all the information asked by composer init, _(*10)

Package name (<vendor>/<name>) [gabriel/my_first_project]: conquerorsoft/my_first_project
Description []: Project created with composer init
Author [Christian Varela <dobleclick.mx@gmail.com>, n to skip]: Christian Varela <cvarela@conquerorsoft.com>
Minimum Stability []:
Package Type (e.g. library, project, metapackage, composer-plugin) []: project
License []: MIT

Define your dependencies.

Would you like to define your dependencies (require) interactively [yes]?
Search for a package: php
Enter the version constraint to require (or leave blank to use the latest version): ^5.6 || ^7.0
Search for a package:
Would you like to define your dev dependencies (require-dev) interactively [yes]?
Search for a package: phpunit/phpunit
Enter the version constraint to require (or leave blank to use the latest version): ^5.7
Search for a package: squizlabs/php_codesniffer
Enter the version constraint to require (or leave blank to use the latest version): 3.*
Search for a package:

{
    "name": "conquerorsoft/my_first_project",
    "description": "Project created with composer init",
    "type": "project",
    "require": {
        "php": "^5.6 || ^7.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^5.7",
        "squizlabs/php_codesniffer": "3.*"
    },
    "license": "MIT",
    "authors": [
        {
            "name": "Christian Varela",
            "email": "cvarela@conquerorsoft.com"
        }
    ]
}

Do you confirm generation [yes]?
Would you like the vendor directory added to your .gitignore [yes]?

10- composer.json file is created, edit it to include your library, _(*11)

{
    "name": "conquerorsoft/my_first_project",
    "description": "Project created with composer init",
    "type": "project",
    "repositories": [
        {
            "type": "vcs",
            "url": "/Users/gabriel/phplibrary/my_first_library"
        }
    ],
    "require": {
        "php": "^5.6 || ^7.0",
        "conquerorsoft/my_first_library": "^0.1"
    },
    "require-dev": {
        "phpunit/phpunit": "^5.7",
        "squizlabs/php_codesniffer": "3.*"
    },
    "license": "MIT",
    "authors": [
        {
            "name": "Christian Varela",
            "email": "cvarela@conquerorsoft.com"
        }
    ]
}

11- commit to git, _(*12)

git add .
git commit -m "Composer init"
git tag -a v0.1.1 -m "version 0.1.1"
git push -u origin master
git push origin v0.1.1

12- Run composer install, _(*13)

composer install

13- create a Changelog file ( this format is recommended: Keep a Changelog ), _(*14)

vim CHANGELOG.md

14- commit to git, _(*15)

git add .
git commit -m "Changelog file added"
git tag -a v0.1.2 -m "version 0.1.2"
git push -u origin master
git push origin v0.1.2

15- Create structure for starting the development, _(*16)

mkdir src && mkdir tests

16- Edit the composer.json file to be this way now:, _(*17)

{
    "name": "conquerorsoft/my_first_project",
    "description": "Project created with composer init",
    "type": "project",
    "keywords": [
        "conquerorsoft",
        "my_first_project",
        "tutorial",
        "phpworld 2017",
        "workshop"
    ],
    "homepage": "http://www.conquerorsoft.com/my_first_project",
    "repositories": [
        {
            "type": "vcs",
            "url": "/Users/gabriel/phplibrary/my_first_library"
        }
    ],
    "require": {
        "php": "^5.6 || ^7.0",
        "conquerorsoft/my_first_library": "^0.1"
    },
    "require-dev": {
        "phpunit/phpunit": "^5.7",
        "squizlabs/php_codesniffer": "3.*"
    },
    "license": "MIT",
    "authors": [
        {
            "name": "Christian Varela",
            "email": "cvarela@conquerorsoft.com",
            "homepage": "http://www.conquerorsoft.com/ChristianVarela",
            "role": "Developer"
        }
    ],
    "minimum-stability": "stable",
    "scripts": {
        "test": "phpunit",
        "check-style": "phpcs -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 src tests",
        "fix-style": "phpcbf -p --standard=PSR2 --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 src tests"
    }
}

17- Create file phpunit.xml, _(*18)

vim phpunit.xml

18- add build to .gitignore, _(*19)

echo build >> .gitignore

19- run composer update, _(*20)

composer update

20- commit to git, _(*21)

echo "build/" >> .gitignore
git add .
git commit -m "Preparation for development"
git tag -a v0.1.3 -m "version 0.1.3"
git push -u origin master
git push origin v0.1.3

21- Add a LICENSE.md file (for this example we chose MIT), _(*22)

vim LICENSE.md

22- Create tests/FirstProjectClassTest.php, _(*23)

vim tests/FirstProjectClassTest.php

23- Create src/FirstProjectClass.php, _(*24)

vim src/FirstProjectClass.php

24- Add autoload section to composer.json, _(*25)

"autoload": {
    "psr-4": {
        "conquerorsoft\\my_first_project\\": "src"
    }
},
"autoload-dev": {
    "psr-4": {
        "conquerorsoft\\my_first_project\\": "test"
    }
},

25- Rum composer dump-autoload, _(*26)

composer dump-autoload

26- commit to git, _(*27)

git add .
git commit -m "Classes from project calling my library"
git tag -a v0.1.4 -m "version 0.1.4"
git push -u origin master
git push origin v0.1.4

27- add repository to Travis and create travis configuration file, _(*28)

vim .travis.yml

28- commit to git, _(*29)

git add .
git commit -m "Travis CI integration"
git tag -a v0.1.5 -m "version 0.1.5"
git push -u origin master
git push origin v0.1.5

29- Change composer.json to use github repository instead of file system local folder, _(*30)

vim composer.json

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/ConquerorSoft/my_first_library"
    }
],

30- run composer update, _(*31)

composer update

31- commit to git, _(*32)

git add .
git commit -m "VCS reference changed for my_first_library in composer.json"
git tag -a v0.1.6 -m "version 0.1.6"
git push -u origin master
git push origin v0.1.6

32- Remove references for repositories in composer.json since now the library is on packagist.org 33- Run composer update, _(*33)

composer clearcache
composer update

34- commit to git, _(*34)

git add .
git commit -m "my_first_library is now taken from packagist"
git tag -a v0.1.7 -m "version 0.1.7"
git push -u origin master
git push origin v0.1.7

35- Link scrutinizer-ci account with github and create .scrutinizer.yml file, _(*35)

vim .scrutinizer.yml

36- commit to git, _(*36)

git add .
git commit -m "Scrutinizer support added"
git tag -a v0.1.8 -m "version 0.1.8"
git push -u origin master
git push origin v0.1.8

37- change composer.json to require version ^1.0.0 for my_first_library, _(*37)

"conquerorsoft/my_first_library": "^1.0"

38- run composer update, _(*38)

composer update

39- commit to git, _(*39)

git add .
git commit -m "Using version ^1.0 from my_first_library"
git tag -a v0.1.9 -m "version 0.1.9"
git push -u origin master
git push origin v0.1.9

40- Create contributing files, _(*40)

vim CONTRIBUTING.md
vim CODE_OF_CONDUCT.md

43- Add more sections to README file, _(*41)

Install
Change log
Testing

44- commit to git, _(*42)

git add .
git commit -m "Improvements to README"
git tag -a v0.1.10 -m "version 0.1.10"
git push -u origin master
git push origin v0.1.10

45- submit the package to packagist.org using the github repository 46- Make the package to be autoupdated in packagist on push - Go to your GitHub repository - Click the "Settings" button - Click "Integrations & services" - Add a "Packagist" service, and configure it with your API token, plus your Packagist username - Check the "Active" box and submit the form, _(*43)

47- Add last version in packagist badge to README.md file, _(*44)

vim README.md

48- commit to git, _(*45)

git add .
git commit -m "Instructions to use packagist.org in README"
git tag -a v0.1.11 -m "version 0.1.11"
git push -u origin master
git push origin v0.1.11

49- Create a gh-pages branch, _(*46)

git checkout -b gh-pages
git push -u origin gh-pages
git checkout master

50- Go to github settings for your repository 51- Choose a theme in GitHub Pages section 52- Your project page is ready now: https://conquerorsoft.github.io/my_first_project/ 53- commit to git and increase version, _(*47)

git add .
git commit -m "Documentation instructions for the project"
git tag -a v1.0.0 -m "version 1.0.0"
git push -u origin master
git push origin v1.0.0

Install

With composer, _(*48)

composer create-project conquerorsoft/my_first_project <project-dir>

Usage

cd src
php -a
    Interactive shell

    php > include ('../vendor/autoload.php');
    php > $fpc=new conquerorsoft\my_first_project\FirstProjectClass();
    php > echo $fpc->encoding("Test string");
    The string 'Test string' is encoded as '2n12 120rwp'
    php > echo $fpc->decoding("2n12 120rwp");
    The string '2n12 120rwp' is decoded as 'test string'
    php > exit