build(export): exclude unnecessary files from dist package

[ramsey]

Description

As I was analyzing files in my project's vendor/ directory, I noticed there were a lot of files included for auth0/auth0-php, since it doesn't have a .gitattributes file telling GitHub what to exclude from the exported zipped files (that Composer downloads).

By including a .gitattributes file that excludes files that aren't necessary for dependents, we save space and bandwidth.

This only affects the zipped files exported from GitHub (i.e., .zip and .tar.gz), which are primarily used by package managers (i.e., Composer) when installing project dependencies.

At a high level, here's what the directory looks like before this change:

❯ tree -L 1 -a -F --dirsfirst
./
├── .github/
├── docs/
├── src/
├── tests/
├── .editorconfig
├── .gitignore
├── .shiprc
├── .styleci.yml
├── CHANGELOG.md
├── EXAMPLES.md
├── LICENSE.md
├── README.md
├── UPGRADE.md
├── composer.json
├── opslevel.yml
├── phpdoc.dist.xml
├── phpstan.neon.dist
├── phpunit.xml.dist
├── pint.json
├── psalm.xml.dist
└── rector.php

5 directories, 17 files

And here's what it looks like after this change:

❯ tree -L 1 -a -F --dirsfirst
./
├── src/
├── LICENSE.md
├── README.md
└── composer.json

2 directories, 3 files

Type of change

• Build improvement

Checklist

• My code follows the contributing guidelines of this repo
• I have commented my code, particularly in hard-to-understand areas n/a
• I have made corresponding changes to the documentation n/a
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works n/a
• New and existing unit tests pass with my changes
• I have read the Auth0 general contribution guidelines
• I have read the Auth0 code of conduct

[github-actions]

👋 Thanks for contributing! Please be patient while a maintainer reviews your PR. In the meantime, please make sure you've read our contributing guide.

[codecov-commenter]

Codecov Report

Base: 94.46% // Head: 94.46% // No change to project coverage 👍

Coverage data is based on head (2d7d49a) compared to base (e139ae0).
Patch has no changes to coverable lines.

Additional details and impacted files

@@            Coverage Diff            @@
##               main     #696   +/-   ##
=========================================
  Coverage     94.46%   94.46%           
  Complexity     1285     1285           
=========================================
  Files            65       65           
  Lines          4441     4441           
=========================================
  Hits           4195     4195           
  Misses          246      246           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[evansims]

Hey @ramsey 👋 Thanks very much for taking the time to prepare this contribution, it's genuinely appreciated. You're quite right, the SDK could definitely benefit from a little trim down. I'll get this merged to be shipped in the next release. 👍