restoreddev / phpapprentice

An online book for learning PHP

PHP Apprentice

PHP Apprentice is a project for sharing knowledge about the PHP programming language. It is an online book that currently includes pages for learning the basics of PHP programming. PHP Apprentice is a work in progress so any constructive feedback is appreciated.

Contributing

PHP Apprentice is built with Hugo. To build the site locally, clone the repository, install Hugo and run hugo server with a terminal in the project root. All of the site pages are written in Markdown and stored in the content directory. To create a new page, the hugo generator will use the default template to generate the markdown file in the content folder: hugo new test.md.

Roadmap

Moving forward, there are three sections I would like to add to the site:

• Web
• Database
• Advanced

The web section will outline the basics of HTTP, how to handle requests and response and generating HTML.

The database section will cover PDO setup, fetching data and securely running queries.

Advanced will hold deeper PHP topics like traits, closures, Composer, auto-loading and namespaces.

If you would like to request a topic or see one section before another, feel free to open an issue.

phpapprentice's Issues

ePub version

It would be nice to have an ePub version of this book as a reference. Can you look into doing this please?

Add install instructions for Linux

Current we have installation instructions for Windows and MacOS. Please consider adding them for Linux as well. A good thing to do might even be to copy some existing content with proper credits.

TODO List

Great work @restoreddev .

Can you provide a TODO list so people can recommend things that could or should be added to the book?

You have mentioned Closures, but I haven't seen anywhere anything about use ().

What about the latest 7.x features, like declare(strict_types=1) or things like magic methods?

Oh you got me excited right now, this looks fantastic! ^_^

Add: Global repo link on website

• I just found the link in your dev.to article
• A link to Github would help contributors

Add: Date of last update

When I hit the frontpage, I could not tell whether this was a tutorial for PHP 5.3 from 2008 or for PHP 7 from 2019. Show relevance by putting the date of last update on the page.

Type hinting functions & methods

What about type hinting introduced with PHP 7.0 and PHP 7.2?

Differentiate between php-cli and php-fpm, etc.

When introducing PHP, I think we should mention that what lies ahead is the php-cli. It might be good to know that there are two "types" of PHP in a system. 🤔

Variable Names

Hey,
This is a great initiative.
I'm a bit concerned when it comes to the style of variable names? Especially when the name of the variable exceeds a single word.
Don't you think, consistence is required? Instead of having different styles? Say either CamelCase or camelCase or variable_name or variablename?

Thank you.

Add: Version of PHP used

This will help people to see that this introduction is up to date (or might not be any longer some day in the future).

How to contribute?

Great work @restoreddev

I would like to know what's the best way to send contributions.

Should a pull request be sent against your develop branch or your master branch?

Thanks