Skip to content

Latest commit

 

History

History
76 lines (55 loc) · 3.51 KB

CONTRIBUTING.md

File metadata and controls

76 lines (55 loc) · 3.51 KB
Raw

How to contribute

The goal is to build an open-source book about PHP functions for new users in the PHP ecosystem. This book collects some useful, unknown, underrated PHP functions or stuff discovered, used, and learned during PHP's daily use. Using frameworks daily, sometimes the perception of the power of the language and the basic functionalities provided by the PHP core could be lost. I see that usually, I used to look at the framework documentation or look for a package in Packagist for the system, array, and string functions instead of using some core functionalities provided by the language. The goal is to cover more and more functions, so the goal is to create new pages, and each page covers 1 specific function.

The functions are grouped into topics:

  • System
  • Array
  • Variables and types
  • String
  • File
  • Extra bonus chapter where I'm collecting some nice cheatsheet

Each function is explained with the description, and examples in markdown files in the src/content/docs directory.

The file name convention

We have all the Markdown files in the src/content/docs directory where you can find the folders for each topic (00-intro, 01-system, 02-array, etc. Each topic ( Intro, System, Array) has a specific folder with the format

  • 2 digits (00 , 01) as topic identifier (progressive number)
  • A "dash" separator -
  • A slug for the topic (intro, system, array)

Following the format above you can have folders like: 00-intro, 01-system, 02-array. Each folder contains files. Each file shows a PHP function. The file name has the format:

  • 2 digits (00 , 01) as function identifier (progressive number);
  • An "dash" separator -;
  • A subtopic slug (by default is the same of the topic), for example system, os, process etc;
  • A "dash" separator -;
  • A slug for the function (array_map, key_exists, ...);
  • The extension (md or mdx).

Following the format described above, you can have in the folder 01-system files with names like 04-sys-getenv.md, 05-sys-exit.md etc

For example, for the file 01-system/04-sys-getenv.md:

  • 01: (the first group of digits) is the progressive number for the system topic;
  • system: is the slug of the topic;
  • 04: is the progress number for functions;
  • sys: the subtopic slug;
  • getenv: the function explained
  • md: the extension

Running locally the project

The rendering part of all the Markdown files is managed via Astro3 + Starlight theme and Bun. If you want to read and browse the HTML eBook and see your changes in realtime when you are working on markdown files in the root directory of the cloned repository (where you have the package.json, bun.lockb files):

  • install the packages via bun install;
  • run the local server via bun run dev

If you want to build the HTML files, you can run the following command:

bun run build

If you want to see the preview of the built files you can run the following command:

bun run preview

Submit ideas or feature requests

Submit your changes

If you want to submit a pull request, please send a GitHub Pull Request to Some drops of PHP with a clear list of what you've done (read more about pull requests).

Please use "main" branch for pull request.