Update teleporter.php to load an archive from the command line

[iain-henderson]

Thank you for your contribution to the Pi-hole Community!

Please read the comments below to help us consider your Pull Request.

We are all volunteers and completing the process outlined will help us review your commits quicker.

Please make sure you

1. Base your code and PRs against the repositories developmental branch.
2. Sign Off all commits as we enforce the DCO for all contributions
3. Sign all your commits as they must have verified signatures
4. File a pull request for any change that requires changes to our documentation at our documentation repo

---

What does this PR aim to accomplish?:

This PR enhances teleporter.php so that it can restore an archive from the command line.

How does this PR accomplish the above?:

Two steps:

1. Move the logic to load a teleporter archive to it's own method
2. Add the necessary logic to call that method when an argument is supplied to teleporter.php

Link documentation PRs if any are needed to support this PR:

pi-hole/docs#818

---

By submitting this pull request, I confirm the following:

1. I have read and understood the contributors guide, as well as this entire template. I understand which branch to base my commits and Pull Requests against.
2. I have commented my proposed changes within the code and I have tested my changes.
3. I am willing to help maintain this change if there are issues with it later.
4. It is compatible with the EUPL 1.2 license
5. I have squashed any insignificant commits. (git rebase)
6. I have checked that another pull request for this purpose does not exist.
7. I have considered, and confirmed that this submission will be valuable to others.
8. I accept that this submission may not be used, and the pull request closed at the will of the maintainer.
9. I give this submission freely, and claim no ownership to its content.

---

• [ x] I have read the above and my PR is ready for review. Check this box to confirm

[yubiuser]

There are some errors reported by the php-cs-fixer. Could you address those please.

__

I'll take care of fixing the PHPStan.

[iain-henderson]

SHould be fixed now, sorry about that.

[yubiuser]

This should fix phpstan: #2450

Once it's merged, please rebase your PR on devel

[yubiuser]

I think it would be nice if you would also make changes to the core repo, as currently pihole -a -t filename will create a backup with [filename].

https://github.com/pi-hole/pi-hole/blob/a4e20f79a34bcc43f3c1063a999a929bfa52a7d4/advanced/Scripts/webpage.sh#L605-L617

We could have a option like pihole -a -t -restore filename

[iain-henderson]

My plan was to make this change, then the change to pihole, then document the new functionality.

[yubiuser]

Please write the change to pihole and the documentation now. The former will allow for easier testing and the latter will prevent forgetting the documentation at all.

[iain-henderson]

pihole updates are in pi-hole/pi-hole#5064

[github-actions]

This pull request has conflicts, please resolve those before we can evaluate the pull request.

[yubiuser]

Thanks for your PR and for keeping it up-to-date. However, things are moving fast and the development of Pi-hole v6 is "advanced" already. FTL will include its own webserver and PHP engine and a lot of things will get removed from the web part of Pi-hole and moved into the FTL realm. We picked up your idea and it's already implemented.
pi-hole/FTL@904e1c7

[github-actions]

Conflicts have been resolved.

[yubiuser]

Please squash all your commits down.

[github-actions]

This pull request has conflicts, please resolve those before we can evaluate the pull request.

[github-actions]

Existing merge conflicts have not been addressed. This PR is considered abandoned.

[iain-henderson]

Are these changes worth pursuing or is the implementation in v6 sufficient?

[yubiuser]

Personally, I think the changes in v6 are sufficient. As your code is php is pretty much will be removed with the transition anyway as we want to get rid of php